File menu commands

The File menu offers the following commands:

New	Creates a new document.
Open	Opens an existing document.
Quick Open	Opens an existing document allowing entry of name without browse dialog.
Close	Closes an opened document.
Close All	Closes all opened documents.
FTP  Open from FTP	Open an existing document from an FTP site.
FTP  Save As to FTP	Saves an opened document to a specified filename on an FTP site.
Revert to Saved	Revert to saved file.
Save	Saves an opened document using the same filename.
Save As	Saves an opened document to a specified filename.
Save All	Saves all modified documents using the same filenames.
Save Selection As	Save Selection to a new file.
Make Copy/Backup	Make a copy/backup of active file.
Compare Files	Compare two ASCII files.
Sort File	Sort the file based on current sort options.
Advanced Sort/Options File	Advanced Sorting and sort options.
UNIX/MAC to DOS	Converts the file format from UNIX or MAC to DOS.
DOS to MAC	Converts the file from DOS to MAC format.
DOS to UNIX	Converts the file from DOS to UNIX format.
ASCII to Unicode	Converts the file from ASCII to UNICODE.
Unicode to ASCII	Converts the file from UNICODE to ASCII.
Insert File	Inserts a file into the active document.
Delete Active File	Deletes the disk file associated with the active window and closes the window losing all changes.
Send Mail	Send file via mail to recipients.
Insert String At Every Increment	Insert a string at the specified increment in the file.
Print	Prints a document.
Print All Files	Prints all open documents.
Print Preview	Displays the document on the screen as it would appear printed.
Page Setup	Set up page headers and footers for printing.
Print Setup	Selects a printer and printer connection.
Favorite Files	Open favorite files, or manage the list.
Exit	Exits UltraEdit.


Edit menu commands

The Edit menu offers the following commands:

Undo	Reverse previous editing operation.
Redo	Reverse the previous UNDO command.
Cut	Deletes data from the document and moves it to the clipboard.
Copy	Copies data from the document to the clipboard.
Paste	Pastes data from the clipboard into the document.
Copy File Path/Name to clipboard	Copies the full pathname of the active file to the clipboard.
Clipboards	Allows the user to select the active Clipboard.
Select All	Selects all the text in the active document.
Select Line	Selects the line with the cursor.
Select Range	Selects a user specified range.
Delete	Deletes the selected text or character at cursor.
Delete Line	Deletes the line with the cursor.
Delete to Start of Line	Deletes from the cursor position to the start of line.
Delete to End of Line	Deletes from the cursor position to the end of line.
Hex Edit	Toggles the state of the editing mode for the current window between HEX and ASCII.
Hex Insert/Delete	Presents a dialog allowing insertion or deletion of bytes in a file while in HEX editing mode.
Spell Check	Invoke the spelling checker, and check the complete file or selected text.
Read Only	Toggle the READ ONLY state of the active file.
Comment Add	Add line comments to selected lines.
Comment Remove	Remove line comments from selected lines.


Search menu commands

The Search menu offers the following commands:

Find	Search document for a text string.
Find Next	Repeat the last find.
Replace	Search document for a text string and replace it with another text string.
Find In Files	Search files on disk for a text string.
Replace In Files	Search files on disk for a text string and replace with another text string.
Find Matching Brace	Find and highlight between matching braces.
Goto Line/Page	Position the cursor at the specified line or page break (or file position in HEX mode).
Toggle Bookmark	Toggles a bookmark at the current line.
Previous Bookmark	Move the cursor to the previous bookmark.
Next Bookmark	Move the cursor to the next bookmark.
Clear All  Bookmarks	Clear all bookmarks.
Word Count	Count the number of words in the document.
Function List	Find and show list of functions in the active document.


Format menu commands

The Format menu offers the following commands:

Reformat Paragraph	Reformat paragraph to wrap at column number with hard returns.
Paragraph FormattingIDD_REFORMAT_PARAGRAPH_ADV	Paragraph Formatting - Align paragraph (Left/Right/Center/Fill)
Convert CR/LF's to Wrap	Convert CR/LF's to Word Wrap for selected text.
Convert Wrap to CR/LF's	Convert Word Wrap to hard CR/LF's for complete file.
OEM to ANSI	Convert OEM character set to ANSI character set.
ANSI to OEM	Convert ANSI character set to OEM character set.
Tab to Spaces	Convert tabs to spaces.
Spaces to Tabs(All)	Convert all spaces to tabs.
Spaces to Tabs(Leading)	Convert leading tabs to spaces.
Trim Trailing Spaces	Trim the trailing spaces from each line.
To Upper Case	Converts the selected text to upper case.
To Lower Case	Converts the selected text to lower case.
Capitalize	Capitalize first character of each word in selected text.
Invert Case	Invert the case (lower/upper) of each character of selected text.
Add Indents	Presents a dialog to allow adding indentation to selected rows of text.
Remove Indents	Presents a dialog to allow removing indentation from selected rows of text.
Insert Page Break	Inserts a page break at the cursor position.


View menu commands

The View menu offers the following commands:

Toolbar	Shows or hides the toolbar.
Status Bar	Shows or hides the status bar.
Open File Tabs	Shows or hides the open file tabs.
Output Window	Shows or hides the output window.
File Tree View	Shows or hides the file tree view.
View as (Highlighting File Type)	View file with selected syntax highlighting.
Set Hex/Column Mode Font	Select the screen font to use for HEX and Column Mode.
Set Font	Select the screen font to use.
Set Printer Font	Select the printer font to use.
OEM Character SetID_FONT_OEM	Force font to OEM Character Set.
Mirror Display Font	Use display font for the printer.
Reset Fonts (Default)	Reset the screen and printer fonts to default settings.
Set Colors	Set the screen colors for text, background and bookmarks.
Show Spaces/Tabs	Show spaces, tabs and new line characters as visible characters.
Set Column Markers	Set Column Markers.
Show Column Marker 1	Enable first column marker defined.
Show Column Marker 2	Enable 2nd column marker defined.
No Scroll Left Side of Marker 1	Toggle fixed pane/columns left of 1st column marker.
Display Ruler	Toggle the column ruler indicator at the top of each Window.
Display Line Numbers	Toggle the line number display at the left of each window.
Spacing - Single	View document with single spacing.
Spacing - 1 ½ Spacing	View document with 1 ½ spacing.
Spacing - Single	View document with double spacing.
ASCII Table	Show ASCII table.
Tag List	Show Tag List.


Column menu commands

The Column menu offers the following commands:

Column Mode	Select column/block mode editing.
Insert/Fill Columns	Specify the text to insert into each column.
Delete Columns	Specify how many/which columns to delete.
Cut Columns	Specify how many/which columns to cut.
Insert Number	Specify number range to insert into each row.


Window menu commands

The Window menu offers the following commands, which enable you to arrange multiple views of multiple documents in the application window:

Duplicate Window	Creates a duplicate window that views the same document.
Cascade	Arranges windows in an overlapped fashion.
Tile Horizontal	Arranges windows in non-overlapped horizontal tiles.
Tile	Arranges windows in non-overlapped vertical tiles.
Next Window	Makes the next window active.
Previous Window	Makes the previous window active.
Arrange Icons	Arranges icons of closed windows.
Minimize All	Minimize all opened documents
Close All Files	Closes all opened documents
Show File in Browser	Show active document/file in browser.
Synchronized Scolling	Synchronize vertical scrolling for all non-minimized windows.
Window 1, 2, ...	Goes to specified window.


Help Memu Commands
Help menu commands

The Help menu offers the following commands, which provide you assistance with this application:

Index	Offers you an index to topics on which you can get help.
Add Help File	Add additional help files to help menu
Using Help	Provides general instructions on using help.
About	Displays the version number of this application.


File New command
New command (File menu)

Use this command to create a new document in UltraEdit.

You can open an existing document with the Open command.

Shortcuts

Toolbar:

Keys:	CTRL+N


File Open command
Open command (File menu)

Use this command to open an existing document (file) in a new window.  You can open multiple documents at once.  Use the Window menu to switch among the multiple open documents.  See Window 1, 2, ... command.

This command presents the File Open dialog.  This allows multiple files to be selected and opened at one time.

Files may also be opened by dragging them from the File Manager into UltraEdit's window and dropping them. (Releasing the mouse button).

You can create new documents with the New command.

Shortcuts

Toolbar:

Keys:	CTRL+O


File Open Dialog
File Open dialog box

The following options allow you to specify which file to open:

FileName

Type or select the filename you want to open.  This box lists files with the extension you select in the List Files of Type box.

List Files of Type

Select the type of file you want to open:

  *.*

Drives

Select the drive in which UltraEdit finds the file that you want to open.

Directories

Select the directory in which UltraEdit finds the file that you want to open.

Read Only

Check this item to open a file in a read-only manner.  Modifications will be disabled.

Network...

Choose this button to connect to a network location, assigning it a new drive letter.

UltraEdit allows multiple files to be selected from the file list and opened at one time (Except UltraEdit-32 on Windows NT*See below).  To select multiple files,  select the first file from the list, then with the CTRL key pressed, select other files in the list.  When all files are selected,  select OK and the selected files will be opened.

Files may also be opened by dragging them from the File Manager into UltraEdit's window and dropping them. (Releasing the mouse button).

*The normal operation of Windows NT (prior to version 4.0) does not permit the selection of long filenames, and multiple selection from the open dialog.  To facilitate both operations, the open dialog box normally allows single selection with long filenames.  If however the SHIFT key is pressed while the file open dialog is invoked multiple selections are permitted with short filenames.


File Close command
Close command/Close All command (File menu)

Use this command to close all windows containing the active document (or ALL Files if Close All Selected).  UltraEdit suggests that you save changes to your document before you close it.  If you close a document without saving, you lose all changes made since the last time you saved it.  Before closing an untitled document, UltraEdit displays the Save As dialog box and suggests that you name and save the document.

You can also close a document by using the Close icon on the document's window, as shown below:


File Save command
Save command (File menu)

Use this command to save the active document to its current name and directory.  When you save a document for the first time, UltraEdit displays the Save As dialog box so you can name your document.  If you want to change the name and directory of an existing document before you save it, choose the Save As command.

Shortcuts

Toolbar:

Keys:	CTRL+S


File Save As command
Save As command (File menu)

Use this command to save and name the active document.  UltraEdit displays the Save As dialog box so you can name your document.

To set a default directory for use by the Save As command use the Default Save Directory setting.

To save a document with its existing name and directory, use the Save command.


File Save Selection As command
Save Selection As command (File menu)

Use this command to save the current selection to a new file..  UltraEdit displays the Save As dialog box so you can name your document.


File Save As dialog box

The following options allow you to specify the name and location of the file you're about to save:

FileName

Type a new filename to save a document with a different name.  A filename can contain up to eight characters and an extension of up to three characters.

Drives

Select the drive in which you want to store the document.

Directories

Select the directory in which you want to store the document.

Network...

Choose this button to connect to a network location, assigning it a new drive letter.


File 1, 2, 3, 4 command
1, 2, 3, 4 command (File menu)

Use the numbers and filenames listed at the bottom of the File menu to open the last four documents you closed.  Choose the number that corresponds with the document you want to open.


File Exit command
Exit command (File menu)

Use this command to end your UltraEdit session.  You can also use the Close command on the application Control menu.  UltraEdit prompts you to save documents with unsaved changes.

Shortcuts

Mouse:	Double-click the application's Control menu button.

Keys:	ALT+F4


Edit Undo
Undo command (Edit menu)

Use this command to reverse the last editing action, if possible.   UltraEdit supports multiple levels of undo (the specific number varies based on the items being undone).  Repeated Undo commands will attempt to step backwards through the previous commands and undo one at a time.  The Redo command may be selected to redo a command that has been undone.  If commands are undone and then a new command is performed, the Redo will no longer allow previous undone actions to be redone.

Shortcuts

Keys:	CTRL+Z or

ALT-BACKSPACE


Edit Redo
Redo command (Edit menu)

The Redo command allows commands that have previously been undone with the Undo to be redone.    If commands are undone and then a new command is performed, the Redo will no longer allow previous undo actions to be redone.

Shortcuts

Keys:	CTRL+A


Edit Cut command
Cut command (Edit menu)

Use this command to remove the currently selected data from the document and put it on the clipboard.  This command is unavailable if there is no data currently selected.

Cutting data to the clipboard replaces the contents previously stored there.

Shortcuts

Toolbar:

Keys:	CTRL+X


Edit Copy command
Copy command (Edit menu)

Use this command to copy selected data onto the clipboard.  This command is unavailable if there is no data currently selected.

Copying data to the clipboard replaces the contents previously stored there.

Shortcuts

Toolbar:

Keys:	CTRL+C


Edit Paste command
Paste command (Edit menu)

Use this command to insert a copy of the clipboard contents at the insertion point.  This command is unavailable if the clipboard is empty.

Shortcuts

Toolbar:

Keys:	CTRL+V


View Toolbar command
Toolbar command (View menu)

Use this command to display and hide the Toolbar, which includes buttons for some of the most common commands in UltraEdit, such as File Open.  A check mark appears next to the menu item when the Toolbar is displayed.

See Toolbar for help on using the toolbar.


Toolbar

The toolbar is displayed across the top of the application window, below the menu bar.  The toolbar provides quick mouse access to many tools used in UltraEdit.

To hide or display the Toolbar, choose Toolbar from the View menu (ALT, V, T).

Click	To

Open a new document.

Open an existing document.  UltraEdit displays the Open dialog box, in which you can locate and open the desired file.

Close an existing document.  If the document has been modified, UltraEdit displays a dialog asking if the changes should be saved.

Save the active document or template with its current name.  If you have not named the document, UltraEdit displays the Save As dialog box.

Print the active document.

Display the active document as it will be printed.

Insert a page break character into the file at the cursor position.

Toggle the Word-Wrap mode.

Toggle the HEX/ASCII editing mode.

Removes selected data from the document and stores it on the clipboard.

Copy the selection to the clipboard.

Insert the contents of the clipboard at the insertion point.

Display the find dialog to search for a string.

Repeat the last find command.

Display the find and replace dialog.

Goto the specified line number or page break (or address in HEX mode).

Make the next document window active.

Make the previous document window active.

Horizontally arrange multiple opened windows in a non-overlapped fashion.

Vertically arrange multiple opened windows in a non-overlapped fashion.

Cascade multiple opened windows in an overlapped fashion.

Display about box for UltraEdit.

Change the mouse pointer to a ? that displays help when clicked on an item.


View Status Bar Command
Status Bar command (View menu)

Use this command to display and hide the Status Bar, which describes the action to be executed by the selected menu item or depressed toolbar button, and keyboard latch state. A check mark appears next to the menu item when the Status Bar is displayed.

See Status Bar for help on using the status bar.


Status Bar

The status bar is displayed at the bottom of the UltraEdit window.  To display or hide the status bar, use the Status Bar command in the View menu.

Status Bar Contents (from left to right)

Help Prompts

The left area of the status bar describes actions of menu items as you use the arrow keys to navigate through menus.  This area similarly shows messages that describe the actions of toolbar buttons as you depress them, before releasing them.  If after viewing the description of the toolbar button command you wish not to execute the command, then release the mouse button while the pointer is off the toolbar button.

Line/column Number

The line number (if enabled) of the cursor in the file, and the column number are displayed together in a single panel.

The active clipboard is shown in the Status Bar following the Line and Column indicator separated with a comma.

In HEX mode this display the cursor position in HEX and Decimal values.

File Type

The file type is shown indication if the file is a DOS file, UNIX file or MAC file.

Date/Time

The date and time the active file was last modified (prior to this session).  For new files the date and time shown is the creation date and time.  The date format is read from the system short date setting.   This may be configured with the Control Panel Regional Settings.

File Size

The file size of the active file.  For new files the date and time shown is the creation date and time.  The file size is updated when UltraEdit writes any changes to the disk.

Status Indicators

The right areas of the status bar indicate which of the following keys are latched down:

Indicator	Description

OVR	The Overstrike mode is selected.

CAP	The Caps Lock key is latched down.


New window command
Duplicate Window command (Window menu)

Use this command to open a new duplicate window with the same contents as the active window.  You can open multiple document windows to display different parts or views of a document at the same time.  If you change the contents in one window, all other windows containing the same document reflect those changes.  When you open a duplicate window, it becomes the active window and is displayed on top of all other open windows.


Window cascade command
Cascade command (Window menu)

Use this command to arrange multiple opened windows in an overlapped fashion.


Window Tiel command
Tile command (Window menu)

Use this command to arrange multiple opened windows in a non-overlapped fashion.


Window Tile Horizontal command
Tile Horizontal command (Window menu)

Use this command to vertically arrange multiple opened windows in a non-overlapped fashion.


Window Tile Vertical command
Tile Vertical command (Window menu)

Use this command to arrange multiple opened windows side by side.


Window Arrange command
Window Arrange Icons Command

Use this command to arrange the icons for minimized windows at the bottom of the main window.  If there is an open document window at the bottom of the main window, then some or all of the icons may not be visible because they will be underneath this document window.


1, 2, ... command (Window menu)

UltraEdit displays a list of currently open document windows at the bottom of the Window menu.  A check mark appears in front of the document name of the active window.  Choose a document from this list to make its window active.


Index command
Index command (Help menu)

Use this command to display the opening screen of Help.  From the opening screen, you can jump to step-by-step instructions for using UltraEdit and various types of reference information.

Once you open Help, you can click the Contents button whenever you want to return to the opening screen.


Using Help command
Using Help command (Help menu)

Use this command for instructions about using Help.


Help About command
About command (Help menu)

Use this command to display the copyright notice and version number of your copy of UltraEdit.


Help Using Help Command
Context Help command

Use the Context Help command to obtain help on some portion of UltraEdit.  When you choose the Toolbar's Context Help button, the mouse pointer will change to an arrow and question mark.  Then click somewhere in the UltraEdit window, such as another Toolbar button.  The Help topic will be shown for the item you clicked.

Shortcut

Keys:	SHIFT+F1


Title Bar command
Title Bar

UltraEdit - <filename>

The title bar is located along the top of a window.  It contains the name of the application and document.

To move the window, drag the title bar.  Note: You can also move dialog boxes by dragging their title bars.

A title bar may contain the following elements:

Application Control-menu button

Document Control-menu button

Maximize button

Minimize button

Name of the application

Name of the document

Restore button


Scroll bars

Displayed at the right and bottom edges of the document window.  The scroll boxes inside the scroll bars indicate your vertical and horizontal location in the document.  You can use the mouse to scroll to other parts of the document.

The horizontal scroll bar is used to position within the current document. The vertical scroll bar is used to change the horizontal viewing area of the document.

The horizontal scroll bar is not shown if WORDWRAP mode is selected.


Size command
Size command (System menu)

Use this command to display a four-headed arrow so you can size the active window with the arrow keys.

After the pointer changes to the four-headed arrow:

1.	Press one of the DIRECTION keys (left, right, up, or down arrow key) to move the pointer to the border you want to move.

2.	Press a DIRECTION key to move the border.

3.	Press ENTER when the window is the size you want.

Note:  This command is unavailable if you maximize the window.

Shortcut

Mouse:	Drag the size bars at the corners or edges of the window.


Move command
Move command (Control menu)

Use this command to display a four-headed arrow so you can move the active window or dialog box with the arrow keys.

Note:  This command is unavailable if you maximize the window.

Shortcut

Keys:	CTRL+F7


System Minimize command
Minimize command (application Control menu)

Use this command to reduce the UltraEdit window to an icon.

Shortcut

Mouse:	Click the minimize icon [image] on the title bar.

Keys:	ALT+F9


System Maximize command
Maximize command (System menu)

Use this command to enlarge the active window to fill the available space.

Shortcut

Mouse:	Click the maximize icon [image] on the title bar; or double-click the title bar.

Keys:	CTRL+F10 enlarges a document window.


Next Window command
Next Window command (document Control menu)

Use this command to switch to the next open document window.  UltraEdit determines which window is next according to the order in which you opened the windows.

Shortcut

Keys:	CTRL+F6


Previous Window command
Previous Window command (document Control menu)

Use this command to switch to the previous open document window.  UltraEdit determines which window is previous according to the order in which you opened the windows.

Shortcut

Keys:	SHIFT+CTRL+F6


Close command
Close command (Control menus)

Use this command to close the active window or dialog box.

Double-clicking a Control-menu box is the same as choosing the Close command.

Note:  If you have multiple windows open for a single document, the Close command on the document Control menu closes only one window at a time.  You can close all windows at once with the Close command on the File menu.

Shortcuts

Keys: 	CTRL+F4 closes a document window

ALT+F4 closes the UltraEdit window or dialog box


Restore command
Restore command (Control menu)

Use this command to return the active window to its size and position before you chose the Maximize or Minimize command.


Switch to command
Switch to command (application Control menu)

Use this command to display a list of all open applications.  Use this "Task List" to switch to or close an application on the list.

Shortcut

Keys:	CTRL+ESC

Dialog Box Options

When you choose the Switch To command, you will be presented with a dialog box with the following options:

Task List

Select the application you want to switch to or close.

Switch To

Makes the selected application active.

End Task

Closes the selected application.

Cancel

Closes the Task List box.

Cascade

Arranges open applications so they overlap and you can see each title bar.  This option does not affect applications reduced to icons.

Tile

Arranges open applications into windows that do not overlap.  This option does not affect applications reduced to icons.

Arrange Icons

Arranges the icons of all minimized applications across the bottom of the screen.


Choose Font Dialog
Choose Font dialog box

UltraEdit allows selection of fonts for the screen and printer.  The selection of screen fonts will also apply to the printer if the Mirror Display Font menu item is checked on the View Menu.  If this item is not checked,  the printer fonts have been selected independently from the screen fonts.

The Font dialog is presented when font selection is selected from the View Menu.  It will be presented if either the Set Font or the Set Printer Font is selected.

The Font dialog presents a selection of installed fonts that may be selected  for use.  If the fonts are being selected for the printer, only fonts applicable to the printer are available.  Selection of font and font size is available.


Find Command
Find command (Edit menu)

This command displays a dialog box for searching the document for the specified text.  The search is performed in the direction specified.  If the string is not found, the search wraps around to the other end of the file and continues the search.  If the string is not found a message is displayed.

In addition to searching for printable characters, tab characters and newline (Carriage Return/Line Feed) characters may be searched for.  To search for a Tab character, use "^t" characters in the dialog.  To search for the newline characters, use "^p" characters in the dialog.  To search for a "^" character, use "^^" in the dialog.

Additionally, the characters "^s" will be replaced with any text that is highlighted when a find is executed and the characters "^c" will be replaced with the contents of the clipboard (up to 1000 characters).  This is useful particularly for macros.  When recording a macro, the option exists to include a find of a specified character string, or using "^s" the macro records the "^s" and when replayed will determine the text highlighted at the time the macro is playing back, likewise when using "^c", these characters will be replaced with the contents of the clipboard at the time the macro is playing back.

Special character summary:

Symbol	Function
^^	searches for a "^" character
^s	searches for selected (highlighted) text when a macro is running
^c	searches for the contents of the clipboard when a macro is running
^b	Matches a page break
^p	Matches a newline (paragraph)
^t	Matches a tab character

Note - ^ refers to the character '^' NOT Control Key + value.

To select all text between the cursor position and the search target, hold down the SHIFT key at the time the search is started with the FINDNEXT button.

The following search options exist:

List Lines Containing String

This option causes UltraEdit to search for all occurrences of the string in the active document and to list them in a dialog box. By double clicking on one of the result lines (or selecting it and clicking on Goto) UltraEdit will position to that line in the file.

Search Direction

The default search direction is down (toward the end of the document). The option to search up or down the document is given. If a search has already occurred in the document, the default search direction is that of the previous search.

Match Case

By default, the search will not be case sensitive. The option to make the search case sensitive is given. If a search has already occurred in the document, the default selection for case sensitivity is that of the previous search.

Match Whole Word Only

By default, the search will not be restricted to matching whole words only. This option allows the search to be restricted to whole words only. This is useful for searching for ' a ', or 'A' without finding all words including 'a'. If a search has already occurred in a document, the default selection will match the previous search.

Regular Expressions

  See Regular Expressions.

If the editor active window is in HEX mode, an additional option exists:

ASCII

By default, in HEX mode, the search will be for hexadecimal characters.  Optionally the find may be configured to search for ASCII characters.

When a find operation is complete the text is highlighted.

Initially after the find is performed, a slim dialog box is displayed enabling easy selection of find and find next. This may be disabled by changing the INI settings.

Shortcut

Keys:	ALT+F3 or Ctrl+F


Edit Find Next Command
Find Next command (Edit menu)

This command repeats the previous FIND command in the forward direction toward the end of the file. The next occurrence of the find text will be found (if present) in the forward direction.

To select all text between the cursor position and the search target, hold down the SHIFT key at the time the search is started with the FIND NEXT menu item or shortcut key.

Shortcut

Keys:	F3


Edit Find Previous Command
Find Previous command (Edit menu)

This command repeats the previous FIND command in the backward direction toward the beginning of the file.  The next occurrence of the find text will be found (if present) in backward direction.

To select all text between the cursor position and the search target, hold down the SHIFT key at the time the search is started with the FIND NEXT menu item or shortcut key.

Shortcut

Keys:	F3


Edit Replace Command
Replace command (Edit menu)

This command displays a dialog box for searching the document for the specified text, and replacing it with a different text. The search is performed in the direction specified.  If the string is not found, the search wraps around to the other end of the file and continues the search.  If the string is not found a message is displayed.

In addition to searching and replacing printable characters, tab characters and newline (Carriage Return/Line Feed) characters may be searched for or replaced.  To specify a Tab character, use "^t" characters in the dialog.  To specify the newline characters, use "^p" characters in the dialog.  To specify a "^" character, use "^^" in the dialog.

Additionally, the characters "^s" will be replaced with any text that is highlighted when a find is executed and the characters "^c" will be replaced with the contents of the clipboard (up to 1000 characters).  This is useful particularly for macros.  When recording a macro, the option exists to include a find of a specified character string, or using "^s" the macro records the "^s" and when replayed will determine the text highlighted at the time the macro is playing back, likewise when using "^c", these characters will be replaced with the contents of the clipboard at the time the macro is playing back.

Special character summary:

Symbol	Function
^^	searches for a "^" character
^s	searches for selected (highlighted) text when a macro is running
^c	searches for the contents of the clipboard when a macro is running
^b	Matches a page break
^p	Matches a newline (paragraph)
^t	Matches a tab character

Note - ^ refers to the character '^' NOT Control Key + value.

Regular Expressions

  See Regular Expressions.

The following replace options exist:

Find Next

Find next finds the next occurrence of the specified text.

Replace

Replace finds the next occurrence of the specified text and replaces it with the new text.

The user may also specify Selected Text under the Replace Where selection and the replace will be limited to the selected area.

Replace All

Replace all finds every occurrence of the specified text and replaces each occurrence with the new text.

The replace all provides the additional options:

Replace in current file - this replaces all occurrences within the current file only.  It determines if the replace should be from the top of the file, or the cursor position based on the setting in this dialog box.

Replace all within the selected text - this replaces only the occurrences of the string that fall within the area of selected text at the time the replace is started.

Replace all in all the open files - this replaces all occurrences of the string in all open files.

Match Case

By default, the search will not be case sensitive. The option to make the search case sensitive is given. If a search has already occurred in the document, the default selection for case sensitivity is that of the previous search.

If the editor active window is in HEX mode, an additional option exists:

ASCII

By default, in HEX mode, the search will be for hexadecimal characters.  Optionally the find may be configured to search for ASCII characters.

When a find operation is complete the text is highlighted.  In HEX mode additional characters may be highlighted if the specified search string crosses a line.  In this case, all characters displayed from the first character of the search string on the first line to the last character of the search string on the last line are highlighted.  If a replace is requested, only the search string will be replaced.

Initially after the replace is performed, a slim dialog box is displayed enabling easy selection of find next and replace operations. This may be disabled by changing the INI settings.

Shortcut

Keys:	CTRL+R


Edit Repeat Command
Repeat command (Edit menu)

Use this command to repeat the last editing command carried out.  The Repeat menu item changes to Can't Repeat if you cannot repeat your last action.

Shortcut

Key:	F4


File Print command
Print command (File menu)

Use this command to print a document.   This command presents a Print dialog box, where you may specify the range of pages to be printed, the number of copies, the destination printer, and other printer setup options.

Shortcuts

Toolbar:

Keys:	CTRL+P


Print dialog box

The following options allow you to specify how the document should be printed:

Printer

This is the active printer and printer connection.  Choose the Setup option to change the printer and printer connection.

Setup

Displays a Print Setup dialog box, so  you can select a printer and printer connection.

Print Range

Specify the pages you want to print:

All	Prints the entire document.
Selection	Prints the currently selected text.
Pages	Prints the range of pages you specify in the From and To boxes.
Copies

Specify the number of copies you want to print for the above page range.

Collate Copies

Prints copies in page number order, instead of separated multiple copies of each page.

Print Quality

Select the quality of the printing.  Generally, lower quality printing takes less time to produce.


Print Progress Dialog

The Printing dialog box is shown during the time that <<YourApp>> is sending output to the printer.  The page number indicates the progress of the printing.

To abort printing, choose Cancel.


File Print Preview command
Print Preview command (File menu)

Use this command to display the active document as it would appear when printed.  When you choose this command, the main window will be replaced with a print preview window in which one or two pages will be displayed in their printed format.  The print preview toolbar offers you options to view either one or two pages at a time; move back and forth through the document; zoom in and out of pages; and initiate a print job.


Print Preview toolbar

The print preview toolbar offers you the following options:

Print

Bring up the print dialog box, to start a print job.

Next Page

Preview the next printed page.

Prev Page

Preview the previous printed page.

One Page / Two Page

Preview one or two printed pages at a time.

Zoom In

Take a closer look at the printed page.

Zoom Out

Take a larger look at the printed page.

Close

Return from print preview to the editing window.


File Print Setup command
Print Setup command (File menu)

Use this command to select a printer and a printer connection.  This command presents a Print Setup dialog box, where you specify the printer and its connection.


Print Setup dialog box

The following options allow you to select the destination printer and its connection.

Printer

Select the printer you want to use.  Choose the Default Printer; or choose the Specific Printer option and select one of the current installed printers shown in the box.  You install printers and configure ports using the Windows Control Panel.

Orientation

Choose Portrait or Landscape.

Paper Size

Select the size of paper that the document is to be printed on.

Paper Source

Some printers offer multiple trays for different paper sources.  Specify the tray here.

Options

Displays a dialog box where you can make additional choices about printing, specific to the type of printer you have selected.

Network...

Choose this button to connect to a network location, assigning it a new drive letter.


File Page Setup Command
Page Setup command (File menu)

<< Write application-specific help here. >>


UltraEdit main index
UltraEdit/UltraEdit-32 Help Index

How To ...

Set and Move to Bookmarks

Change Font Selection

Change Insert/Overstrike modes

Change Tab Settings

Drag and Drop files from the File Manager

Drag and Drop Editing

Open Multiple Files at Once

Delete the active file

Edit in HEX mode

Indent Line Automatically

Load a Macro

Save a Macro

Record a Macro

Stop Recording  a Macro

Playback a Macro

Select Next DocumentWindow

Select Previous DocumentWindow

Commands

File menu

Edit menu

Search menu

Project menu

View menu

Format menu

Column menu

Macro menu

Advanced menu

Window menu

Help menu

Toolbar Commands

Keyboard Commands

Right Mouse Button Commands

Command Line Parameters

Command Line

Information

Registration

Latest Version

License Agreement - Unregistered

License Agreement - Registered


Macro menu commands

The Macro menu includes commands that let you record, playback, load and/or save them.

What is a macro?

A macro is a series of keystrokes or actions that have been 'recorded' in  the order performed. A macro allows you to 'record' a series of keystrokes or actions and then 'playback', or repeat, the recorded keystrokes and/or actions. A macro is typically used to perform a similar set of actions multiple times on each occurrence of a given text string.

UltraEdit supports multiple macros and one macro may invoke another macro.

Macros may be automatically loaded and executed when the editor starts up.  See the Command Line Parameters for more information.

For more information, select the Macro menu command name:

Load Macros	Loads a macro file.
Load and Append to Existing…	Loads and appends a macro file to any macros already resident.
Save all Macros	Saves all macros to a file.
Set Auto Load	Specify the macro to load at startup.
Edit Macro	Edit a macro.
Delete All	Delete all resident macros.
Delete Macro/Modify Hot Key	Delete a macro or modify its Hot Key.
Record a Macro	Starts recording a macro.
Stop Recording a Macro	Stops recording a macro.
Play again	Playback last macro again.
Playback any macro or play a Macro Multiple Times	Playback any macro or playback a macro multiple times.
Warn on Exit if Macro Not Saved	Warn user macros are not saved when exiting.


Advanced menu commands

The Advanced menu provides access to some of the advanced capabilities of UltraEdit.  These include:

Configuration:	A Tabbed dialog with access to the following pages:
	General Items
	Edit
	Find
	Backup
	Spell Checker
	Toolbar
	Key Mapping
	Syntax Highlighting
	File Types
	File Associations
	Directories
Display/Modify Templates	Display or modify the user definable templates.
Insert Template	Insert a user defined template into the file.
DOS Command	Run a DOS command and capture its output.
Last DOS Command	Repeat the last DOS command.
Run Windows Program	Run a Windows program.
Alternate Capture Method	Alternate capture method for capturing output.
Tool Configuration	User definable tool configuration.


Macro Load
Macro Load (Macro menu)

The Macro Load command presents a dialog box for loading a previously saved set of macros from a disk file. The dialog box allows selection of a file from any file device known to the system. The default filename presented is UltraEdit.MAC, although any filename is acceptable.

When a file is selected for loading a check is made to ensure the file is an UltraEdit macro file.


Macro Load and Append to Existing
Macro Load and Append to Existing… (Macro menu)

This function allows a macro file to be loaded appending the file to the macros already resident, unlike the Macro Load command that deletes all resident macros before loading the file.

A dialog box is presented for loading a previously saved set of macros from a disk file. The dialog box allows selection of a file from any file device known to the system. The default filename presented is UltraEdit.MAC, although any filename is acceptable.

When a file is selected for loading a check is made to ensure the file is an UltraEdit macro file.


Macro save all
Macro Save All (Macro menu)

The Macro Save All command presents a dialog box for saving to a disk file the macros that have been recorded using the Macro Record command. The dialog box allows selection of a file from any file device known to the system. The default filename presented is UltraEdit.MAC, although any filename is acceptable.

This command is available only if a macro has been recorded or loaded.


Macro Set Auto Load
Macro Set Auto Load (Macro menu)

The Macro Set Auto Load command allows you to specify a macro file that should be loaded automatically when UltraEdit is started.

This also allows a specific macro to be executed a specified number of times, if required.  A macro file may be loaded automatically without executing a macro.

This method of loading a macro at startup overrides the Command Line parameters for loading a macro.  If no macro is specified to be loaded here, the command line parameter setting, if specified, will be used.


Macro Modify
Delete Macro/Modify Hot Key (Macro menu)

This command allows the user to delete a macro or modify the hot key associated with any macro.  A dialog box is presented that shows all of the macros, and allows any macro to be selected and its hot key modified (or the macro may be deleted).  No support is provided to modify the contents of a macro.  For more details on the hot key assignments see Macro Recording.


Macro Delete All
Macro Delete All (Macro menu)

This command deletes all the resident macros.  If any of the macros have been created or modified since the file was saved, the user is prompted allowing the macros to be saved prior to deleting them.


Macro recording
Macro Record (Macro menu)

The Macro Record command starts 'recording' keystrokes and actions for later playback. Recording is stopped when the Stop Recording menu selection is made.

This command presents the Macro Definition dialog allowing you do define the macro name and hot key if required.  When the dialog is dismissed with the OK button the macro recording starts.

Notes for recording macros:

The Macro Record function records all keystrokes and characters typed while recording is selected. All keystrokes are recorded, including key combinations that move to end of line, top or bottom of document etc. Care should be taken to ensure that when the macro is to be Played back the same keystrokes are appropriate.

Mouse motion and scrolling is NOT recorded while recording is selected. All positioning should be performed with the keyboard.

Macros will record and playback the Next Window and Previous Window commands.

Find and Replace is supported while recording is selected (see Find for special characters that are useful with macros). Any find or replace functions will be recorded directly as performed, unless using special characters that are replaced when executing with the contents of the clipboard or the highlighted text, see Find. If all, or any occurrences of "FIND" are replaced with "REPLACE" in a file, the same action will be performed when the macro is Played back.

Cut, Copy and Paste are also supported while macro recording is selected. Any of these operations will be performed dynamically as the macro is Played back. That is to say that if an item is cut while recording the macro, an item will be cut while playing back the macro based on the selected text at the time the macro is being played back. If the selected text is different while playing back the macro, from when the macro is recorded, the text cut while playing back the macro will also be different.

As multiple macros are now supported, this command is available when macros already exist.

HEX editing is now supported within macros.

The following commands are supported when recording a macro:

Keyboard entry - typing characters

Cursor positioning

Selecting text with keyboard commands

Cut, copy, paste

Find/replace

HEX mode switching and editing

File open, close, save

Bookmarks

Playing macros - nesting macros

Window switching - next/previous window

Insert/Overstrike selection

Unix/Mac to DOS

DOS to Unix

DOS to MAC

Convert Wrap to CR/LFs

Convert CR/LFs to Wrap


Macro Definition Dialog

The macro definition dialog is shown when a new macro is created either from the Macro Record command or from the Edit Macro command.

It allows a name to be given to the macro, and a hot key assignment to be given to the macro.   After pressing OK, the macro recording starts if invoked from the Macro Record command.

The hot key assignment allows the user to specify a key combination that will automatically invoke the macro.  If a key assignment is chosen that is already used by UltraEdit, the key assignment will override UltraEdits assignment.

The following keys are supported:

A-Z

0-9

F1-F12

Space, Enter and Tab

In addition, the key modifiers CONTROL, ALT and SHIFT may be selected.

It is not required that a name be entered, or a hot key assignment be made.

Default behavior shows a Cancel Dialog while the macro is executing.  For macros that execute quickly this may not be desired and may be disabled by deselecting the "Show Cancel Dialog for this macro" setting.

During Macro Playback a find and replace command may result in the search string not being found.  The default behavior in this case is to stop the macro execution.  For some macros, possibly where a Replace All is being performed it is desirable not to stop the macro playback.  In this case, select the "Continue if a Find with Replace Not Found".


Macro editing
Edit Macro (Macro menu)

The Edit Macro command allows a new macro to be created and edited or an existing macro that has previously been generated with this command or with the Macro Record command to be edited.

In many cases, it is easier for the user to generate the macro by recording it with the Macro Record command and then to edit it if necessary.  The learning curve is less with this approach.

Commands

A macro is a series of commands that may later be played back automatically to modify the file.  The left hand side of the dialog shows the current macro being edited and an editable window containing the commands that make up the macro.

The commands in the macro must be one of the predefined commands.  These predefined commands are shown on the right hand side of the dialog.  If the mouse is double clicked on the command it is automatically added to the macro, or clicking on the arrow to the left of the commands will add it to the macro.

Parameters

Many of the commands have numeric parameters.  The numeric parameters are quite obvious, such as "Goto Line #" or "Goto Page #".  However, some of the commands such as Find and Replace, Sort etc. have additional parameters that are not numeric.  These additional parameters are listed below the command list for easy selection.

Creating a New Macro

To create a new macro from this dialog click the New/Macro button.  This displays the Macro Definition dialog allowing you to define the macro name and hot key if required.

When this new macro is created, three macro commands are automatically added to the macro:

- Insert Mode or OverStrike Mode

- ColumnModeOn or ColumnMode Off

- HexOn or HexOff

These three commands are added based on the current state of the editor.  The purpose is to establish a known state each time the macro is played.  If a macro is recorded in one mode and played back in another the results may be unpredictable.  Establishing the mode at the beginning of the macro helps to ensure the expected results are achieved.  These commands may be modified as required.

Once an edit macro has been created, it may be edited.

Modifying The Macro

To modify the macro, commands may be typed directly into the macro edit box or selected from the command list.  Commands are not case sensitive but must be spelled exactly as shown in the command list.

The table below shows the commands that may be added to any parameters:

Commands	Parameters*	Description
""		Insert text between the quotes ("").  The closing quote must be the last non-space character on the line.  The characters to be inserted may cross multiple lines.  To insert a quote ("), place it as needed in the text being inserted and ensure the last character is also a quote.  To insert just one quote character (") the line should look like this: """ To insert a new line, add a line between the open quote and close quote.  To insert two lines with 1 and 2 at the beginning of the lines the command should be as follows: "1 2"
Bottom		Jump to end of file.
CloseFile		Close the active file.
ColumnModeOff		Turn the column mode off.
ColumnModeOn		Turn the column mode on.
ColumnCut		Cut selected columns in column mode.
ColumnDelete		Delete selected columns in column mode.
ColumnInsert	""	Insert string between quotes into selected columns.
ColumnInsertNum	start number increment LeadingZero (optionally)	Insert number in selected columns.
Copy		Copy selected text to the clipboard.
Cut		Cut the selected text from the file to the clipboard.
DeleteLine		Delete the current line.
DosToMac		Convert the file (line terminators) to MAC format.
DosToUnix		Convert the file (line terminators) to UNIX format.
Else		Else function for an IF… command. IfSel … Else do these commands if the IfSel failed. Endif
EndIf		Ends the block of instructions controlled by the IfFound/IfNotFound statements.
EndLoop		End of loop - go back to beginning of the loop - see the Loop command.
EndSelect		Stop Selecting Text (see Start Select for details).
ExitLoop		Exit loop and go to first command after the loop (after the EndLoop command) - see the Loop command.
ExitMacro		Exit Macro without processing any additional commands or returning an error.
Find	"" (Search string in quotes) MatchCase - indicates the search is case sensitive (optional) MatchWord - indicates the search string will only match instances that are a complete word (optional) RegExp - Indicates a Regular Expression search (optional) Up - Indicates search in reverse direction (optional)	Find the string in quotes "" based on the parameters specified.
GetString	prompt	Prompts the user for a string that is inserted in the file at the current location.  The prompt is the prompt or question that is displayed to the user when the macro is run. GetString "Where country do you live in?
GetValue	prompt	Prompts the user for a value that is inserted in the file at the current location.  The prompt is the prompt or question that is displayed to the user when the macro is run. GetValue "How old are you?
GotoBookMark		Jump to the next bookmark.
GotoBookMarkSelect		Jump to the next bookmark and select text from cursor position to bookmark.
GotoLine	Line number (#)	Jump to specified line number.
GotoLineSelect	Line number (#)	Jump to specified line number and select text from cursor position to line.
GotoPage	Page number (#)	Jump to specified page number.
GotoPageSelect	Page number (#)	Jump to specified page number and select text from cursor position to page number.
HexDelete	Number of bytes to delete (#)	Delete the specified number of bytes from the file.
HexInsert	Number of bytes to insert (#)	Insert the specified number of bytes into the file.
HexOff		Turn Hex mode off - switch to text mode.
HexOn		Turn Hex mode on.
IfCharIs	"string" or number.	This checks if the current character at the cursor position is in the specified string, or matches the decimal number. IfCharIs "xyz … do these commands if the current character is x, y, or z. … EndIf IfCharIs 34 … do these commands if the current character is decimal value 34 - a double quote. … EndIf
IfColNum	number.	This checks if the current cursor position is the specific column number. IfColNum 10 … do these commands if the current cursor position is column 10.  Column 1 is the first column. … EndIf
IfEof		This checks if the current cursor position is at the end of file. IfEof … do these commands if at end of file … EndIf
IfFound		This checks the results from the last find command in the macro and will execute the next set of instructions up to an "EndIf" if the last search was successful: Find "something" IfFound … do these commands if "something" was found … EndIf
IfNotFound		This checks the results from the last find command in the macro and will execute the next set of instructions up to an "EndIf" if the last search was NOT successful: Find "something" IfNotFound … do these commands if "something" was NOT found … EndIf
IfSel		This checks if there is currently any selected text within the active file. IfSel … do these commands if "something" is selected … EndIf
InsertMode		Change text editing mode to insert mode for characters typed
InvertCase		Invert the case of selected text.
Loop	x	Loop x times where x is a number.  A value of 0 indicates Loop forever. i.e. Loop 10 … do these commands 10 times … EndLoop
Key	Backspace Ctrl+ DEL DOWN ARROW END HOME LEFT ARROW PGDN PGUP RIGHT ARROR UP ARROW	Insert a key command into the macro.  Generally used for navigation in the file and for backspace or delete.  The "Ctrl+" modifier may be used as with normal editing to modify the command. For text input the "" string command is used, not the Key command.
NextWindow		Switch to next window.
Open	Filename ("")	Open the specified file.  The Filename must be in quotes.  "^s" may be used in the filename.  UltraEdit will replace this with the currently selected text in the active Window.  Likewise, "^c may be used and UltraEdit will replace this with the contents of the clipboard.
OverStrikeMode		Change text editing mode to overstrike mode for characters typed.
Paste		Paste the contents of the clipboard into the file.
PlayMacro	Number of times to play it (#) Macro name ("")	Play another macro.  Specify the number of times to play the macro first, then the macro name.  The macro name must be in quotes.
PreviousWindow		Switch to previous window.
Replace	All - Replace all occurrences. AllFiles - Replace in all open files (requires All). Selected Text - Replace in selected text (Requires All). Replace String ("") - String to replace the found string.	The Replace command replaces the previously found string with the string specified.  This command MUST follow a Find command. As with the Find string, the replace string must be in quotes. The closing quote must be the last non-space character on the line. The replace string may cross multiple lines however, if the last non-space character in any line is a quote it will terminate the string.  All special characters permitted by the Replace Command are permitted here.
ReturnToWarp		Convert hard returns to word wrap.
RunTool	"menu name of tool to run"	Run a tool.  The tool must be configured from Tool Configuration in the Advanced menu.
Save		Save active file.
SaveAs	Filename ("")	Save the active file as the filename specified. The Filename must be in quotes.  "^s" may be used in the filename.  UltraEdit will replace this with the currently selected text in the active Window.  Likewise, "^c may be used and UltraEdit will replace this with the contents of the clipboard.
SelectToBottom		Select all text from the current position to the end of file.
SelectToTop		Select all text from the current position to the top of file.
SelectWord		Select the current word (same as double clicking a word).
SortAsc	IgnoreCase - Ignore case of characters in the sort. RemoveDup - Remove duplicate lines.	Sort the file, or selected text in ascending order.
SortDes	IgnoreCase - Ignore case of characters in the sort. RemoveDup - Remove duplicate lines.	Sort the file, or selected text in descending order.
SpacesToTabs		Convert (leading) spaces within the file to tabs.
SpacesToTabsAll		Convert (all) spaces within the file to tabs.
StartSelect		Start selection.  This turns the selection mode on.  Any cursor movement or positioning will be with selection on and the text is selected.  EndSelect will stop the selection mode.  The selected text will remain selected until another command causes it not to be selected as with normal editing.
TabsToSpaces		Convert all tabs within the file to spaces.
Template	Template Number (#)	Insert the specified template into the file.
TimeDate		Insert the time and date into the file at the current location.
ToCaps		Capitalize each word in the selected text.
ToggleBookMark		Set or remove a bookmark at the current line.
ToLower		Convert the selected text to lower case.
Top		Jump to top of file.
ToUpper		Convert the selected text to upper case.
TrimTrailingSpaces		Trim trailing spaces from each line of current file.
UnixMactoDos		Convert the active file (line terminators) from Mac/Unix to DOS format.
WrapToReturn	Column number (#) at which wrap is performed. Zero for the column number indicates the wrap is to occur at the window boundary.	Convert the file from word wrap to hard returns.

* Where (#) exists in the parameter column a numeric value is to be entered for that parameter. Likewise, where ("") exists in the parameter column a stringis to be entered between quotes. The text only describes the meaning of the parameter.  All string parameters must be the last parameter.


Macro stop recording
Macro Stop Recording (Macro menu)

The Macro Stop Recording command stops capturing keystrokes and actions that was started when the  Macro Record function was selected. Once a macro has been recorded and the session has been stopped with this command, the macro may be played back by selecting the Macro Play Again or Macro Play Any/Multiple Times  command.

After a macro has been recorded, it may by saved using the Macro Save All command.


Macro playback
Macro Playback (Macro menu)

The Macro Playback command allows a macro that has been recorded with the Macro Record command to be replayed. The macro is replayed one time for each invocation of the command. To replay the macro multiple times use the Macro Playback Multiple Times command.

This command is not available if a macro record has not been recorded or loaded.


Macro playback multiple times
Macro Playback Multiple Times (Macro menu)

The Macro Playback Multiple Times command allows a macro that has been recorded with the Macro Record command to be replayed multiple times. A dialog box is presented that prompts the user for a number between 1 and 100000 that specifies the number of times the macro should be replayed. To replay the macro a single time use the Macro Playback command.

This command is not available if a macro record has not been recorded or loaded.


Macro Not Saved Warning
Warn on Exit if Macro Not Saved(Macro menu)

This indicates and determines if a warning will be issued when UltraEdit closes, or a new macro file is loaded and the existing macros have been modified but not saved.

If this is not checked, no warning will be given.


Word Wrap command
Word Wrap Settings (Configuration Page/Edit)

Use word-wrap to automatically wrap words to the next line at the horizontal edge of the active window, or at a specified column.

There are four selectable modes of operation for word wrap:

Wrap at window boundary, without inserting a hard return.

Wrap at a specified column number without inserting a hard return.

Wrap at a specified column number and insert a hard return.

With this option, an additional option specifies if the file should be automatically wrapped on input.  If selected, the file is wrapped on input, otherwise text is only wrapped as it is modified.

Note - The column wrap above wraps on a word boundary.  This may mean that the wrap does not occur on the specified column but on a lesser column number.

Absolute wrap after specified column.  This will wrap exactly at the specified column.

If the option to wrap at a specified column AND insert a hard return is made, the file is automatically modified to wrap at the column and insert appropriate hard returns.

Additionally, the Reformat Paragraph paragraph feature may be used to wrap a paragraph to the specified column number.

If the editor active window is in HEX mode, this command is not available.


About command (Help menu)

Use this command to display the copyright notice and version number of your copy of UltraEdit.


Bookmarks
Setting and Moving to Bookmarks (Search menu)

UltraEdit allows you to set a "bookmark" to mark a position in a file. Once a bookmark has been set at a line, you may use menu or keyboard commands to move to that line.

 To set a bookmark:

1.	Move the cursor to the line where you want to set a bookmark.

2.	From the Search menu, choose Toggle Bookmark.

Shortcut

Keys:	CTRL+F2

To remove all the bookmarks, use the "Clear All Bookmarks" menu item.

To move to the next bookmark after the insertion point, choose Next Bookmark from the Search menu.

Shortcut

Keys:	F2

To move to the previous bookmark after the insertion point, choose Previous Bookmark from the Search menu.

Shortcut

Keys:	Alt+F2

When the Shift Key is pressing at the same time as performing the Goto Bookmark function the current selection (if present), or a new selection will be extended to select text up to the cursor position following the command.


Line Indentation
Automatic Line Indentation (Edit Configuration Page)

UltraEdit provides automatic line indentation.  When automatic line indentation is enabled, UltraEdit automatically indents a line to match the indentation of the previous line.  The indentation is performed by inserting spaces into the document.

Additionally UltraEdit supports language specific indentation and out-denting.  This provides for additional indenting after a certain character/string to indent a block of code and out-denting after a closing character/string.  See the indentation section under Syntax Highlighting for details.

This option is only active in INSERT mode, not in OVERSTRIKE mode.


File Delete command
Delete Active File command (File menu)

Use this command to close the active document and delete its associated file from the disk. This command prompts the user to ensure the file should really be deleted. If the file is deleted from the disk, it is no longer available. USE THIS COMMAND WITH CARE.


Hex Editing
Hex Mode Editing (Edit menu)

The HEX Edit command selects the editing mode for the active window. The mode is toggled between Hexadecimal (HEX) and ASCII. The ASCII mode of editing is typically used for any ASCII (text) based files. In the ASCII mode, UltraEdit allows normal operation of all functions and allows any characters to be typed.

The HEX mode of editing is typically used for non ASCII files, or binary files. These files typically contain non-printable characters, and are not text files.

The following restrictions apply when HEX mode is selected:

Insert mode is not supported.

When the HEX mode of editing is selected for a given window, UltraEdit splits the screen area into three areas as shown:

File Offset:	Hexadecimal Representation	; ASCII Representation
000000h:	30 31 32 33 34 35 36 37 38 39 30 31 32 33 34 35	;123456789012345

The number of HEX characters shown in a line may be specified in the General Options configuration page.

The file offset area shows the current byte offset of the character at the beginning of the line to form the beginning of the file.

The hexadecimal representation, shows the hexadecimal value of each file byte as a two character field, separated from the next byte by a space (' ').

The ASCII representation provides the view of printable characters. Non printable characters are shown with a period character ('.').

Editing may be performed in the ASCII area, or the HEX area. Positioning from one area to the other is performed by clicking the left mouse button in the appropriate area or by pressing the TAB key. The TAB key switches the cursor between the ASCII and HEX area and maintains the character offset in the file.  In the HEX area, the only valid characters are, 0-9, A-F, and a-f. All other characters are invalid and are ignored. In the ASCII area, any printable character is valid, and will be accepted with the exception of <CR> and ENTER.

Editing in either the ASCII are or the HEX area automatically updates the other area after each valid character is typed.

All modifications are performed in OVERSTRIKE mode.

To insert or delete characters in HEX mode, use the HEX Insert/Delete selection from the Edit menu.

Cut, copy and paste are supported in HEX mode.

Shortcut

Keys:	CTRL+H


Insert/Overstrike mode
Insert/Overstrike Modes

UltraEdit allows editing in both insert and over strike modes. The mode of operation is indicated in the status bar at the bottom of the UltraEdit window. The insert/overstrike mode is changed with  the INSERT key. The mode is toggled when the INSERT keyis pressed.

If insert mode is selected, the second area of the status bar is clear, if overstrike mode is selected, the second area of the status bar shows 'OVR'.

Insert mode causes a key to be inserted into the document at the position of the cursor. Overstrike mode causes the character immediately to the right of the cursor to be overwritten by the new character.

If the editor active window is in HEX mode, the active window is always in overstrike mode.  To insert text in HEX mode, use the HEX Insert/Delete selection from the Edit menu.


Tab Settings
Edit Settings (Configuration Page/Edit)

The edit settings tab provides for options associated with general editing.

Auto Indent	Toggles the state of automatic line indentation for UltraEdit.
Allow Positioning Beyond Line End	This option allows the cursor to be positioned beyond the end text in a line.
Disable Drag and Drop	Disable the Drag and Drop Editing feature.
Home Key Always Goto Column 1	When checked, the home key always positions to the first column.  If not checked, the home key will go to the first non-space character unless in that position, in which case it will go to the first column.

UltraEdit allows the tab and Word-Wrap settings to be based on the file extension of the file.  Initially the defaults will be used.  To add an extension type click on "Change List" and a dialog will be displayed allowing you to add or edit up to 10 extension types.

The tab and Word-Wrap settings will change to reflect the extensions shown.  The "default" setting is used for any files that do not match the user defined extensions.

Tab Settings

UltraEdit allows for selection of TAB stops and for TAB characters to be replaced by spaces automatically while editing.

Use spaces in place of Tabs, if checked instructs UltraEdit to replace TAB characters with spaces.  If this selection is made, the Tab Stop Value allows selection of the number of spaces to use.

The Tab Stop Value specifies the TAB stops, or the number of spaces to use in place of a TAB character.

If the option to replace TABs with spaces is chosen,   UltraEdit inserts spaces in place of TABS but maintains the TAB stop spacing using the number of spaces specified.

UltraEdit does not replace existing TAB characters that may exist within the document.

Word-Wrap settings.


Font Selection
Set Font (View menu)

The Set Font menu item presents the Choose Font dialog box that allows selection of different fonts and font sizes.  The selection made will apply to the screen fonts and will also be applied to the printer font if the Mirror Display Font menu item is checked on the View Menu.  If this item is not checked,  the printer fonts have been selected independently from the screen fonts.

Font selections may be reset to default values by selecting the Reset Fonts menu item.

Note:  If the printer does not support the font,  Windows automatically adjusts to the closest font.


Font Selection (Printer)
Set Printer Font (View menu)

The Set Printer Font menu item presents the Choose Font dialog box that allows selection of different fonts and font sizes for use by the printer.  The selection made will apply only to the printer fonts.  Selection of the printer fonts unchecks the Mirror Display Font menu item on the View Menu.  Only fonts applicable to the printer will be available.

Font selections may be reset to default values by selecting the Reset Fonts menu item.


Mirror Display Font
Mirror Display Font (View menu)

The Mirror Display Font menu item instructs UltraEdit to use the font that is selected for the screen on the printer.  This overrides any font selection already made for the printer with the Set Printer Font menu item.


Reset Fonts
Reset Fonts (Default) (View menu)

The Reset Font menu item instructs UltraEdit to reset user selections of the screen and printer fonts to the default settings.  Any user selections of the screen fonts made with the Set Font menu item or printer fonts made with the Set Printer Font menu item will be lost.


Add Indents
Add Indents (Format menu)

The Add Indents menu item presents a dialog that allows the user to specify the number of spaces to add at the beginning of each of the selected (highlighted) lines.  UltraEdit starts adding the specified number of spaces to each line beginning with the first highlighted line and ending with the last line that has at least one character selected (highlighted).

The Indents will be added to all lines stated above,  irrespective to and indentations that may already exist.

To remove indentations, use the Remove Indents menu item on the Format Menu.


Remove Indents
Remove Indents (Format menu)

The Remove Indents menu item presents a dialog that allows the user to specify the number of spaces or tabs to remove from the beginning of each of the selected (highlighted) lines.  If the checkbox specifying removal of all indents is checked, UltraEdit will remove ALL indentation at the beginning of the selected lines.  UltraEdit starts removing the indents beginning with the first highlighted line and ending with the last line that has at least one character selected (highlighted).

If no indentation is found at the beginning of a selected line, no changes are made to that line.

To add indentations, use the Add Indents menu item on the Format Menu.


Hex Insert/Delete
Hex Insert/Delete (Edit menu)

The HEX Insert/Delete command allows the insertion or removal of characters at the current cursor position while in the HEX mode.  This command presents a dialog that allows selection to insert or delete characters and requires the number of characters that are to be inserted or deleted to be specified.

If insert is selected, UltraEdit will insert the specified number of characters in the file and initialize them to a hexadecimal value of 20 (ASCII space).  The characters may them be modified as required.

If delete is selected, the specified number of characters will be removed from the file beginning at the cursor position.

Shortcut

Keys:	CTRL+D


Line Numbers
Disable Line numbers (General Configuration Page)

The Disable Line Numbers option allows the line number display in the status bar to be disabled.  Under normal circumstances this option should be left unchecked.  For very large files,  file positioning may be slowed down while UltraEdit establishes the line number.  In this case the line numbers may be disabled.

If the option is checked, line numbers are disabled, if unchecked line numbers are enabled.


Option to show slim find/replace dialog
Show Slim Find Dialog (Find Configuration Page)

This option determines if the slim Find dialog with find next and find previous buttons should be shown after the find command is initially started.

If set, the dialog is shown at the top of the screen.


Option to continue search at end of file
Continue Search at End of File (Find Configuration Page)

This option determines if the search for a string is to be continued at the opposite end of the file if the string is not found.

If this option is not set, UltraEdit does NOT wrap around at the end of file when searching for a string.  The default behavior is for UltraEdit to continue the search from the opposite end of the file when a target is not found.


Drag and Drop Files

UltraEdit supports dragging and dropping files from the Explorer or File Manager into an open session of UltraEdit.  Files may be selected from the File Manager (multiple files may be selected) and dragged into the UltraEdit window.  If the mouse button is released with the mouse over UltraEdit's window the files selected will automatically be opened for editing with UltraEdit.


Command Line; INI File Selection
Command Line Parameters

UltraEdit supports command line parameters specifying files to be opened.  UltraEdit allows multiple files to be specified in the command line.  Each of the files specified will be opened when UltraEdit starts up.  The filenames on the command line should be separated with a space (' ').  For long filenames, they should be enclosed in quotes "".

Additionally, UltraEdit supports two other methods of opening files on the command line:

Wildcard characters	UltraEdit will accept any normal wildcard specification for files to be opened, i.e. "*.c" will open all files with the ".c" extension.

File containing list of files to be opened	You may specify that the filename on the command line contains a list of files to open by using a "/f" parameter on the command line.  In this case, UltraEdit will read each line of the files on the command line, and attempt to open each file.  The file specified on the command line when the "/f" parameter is used must contain only filenames, and each filename must be on a separate line.

UltraEdit accepts a "/r" parameter on the command line to open files in a read-only manner.

To specify the line and column number at which to position the cursor when the file is opened, the line number and column number should follow the filename immediately separated from the filename by a '/' character follows:

filename/5/2	This opens the file with the cursor positioned at line 5, column 2.  The line number may be specified without specifying the column number.

The separator character '/' was a comma in previous releases, however as this is a valid character for filenames it has been changed.  If it is preferred to use the comma or another character, the following line may be added to the INI file:

LineColumnChar= ,

where the comma may be any character except a colon ':', however UltraEdit will not be able to open a file that contains this character.

UltraEdit accepts a '/P' or '/p' on the command line.  This instructs UltraEdit to print the files that appear on the command line automatically and to exit when the files have been printed.

UltraEdit permits the INI file used for UltraEdit settings to be specified by the user.  If the command line contains "/I=filename" this is used.

Example: /i=c:\windows\uedit32.ini

The filename must follow the /i= immediately.  It can be a long name with spaces, in which case it must be in quotes.

For more information on the INI settings see INI File Selection.

UltraEdit allows macros to be automatically invoked from the command line with the following syntax added to the command line:

/M,E,5="full path of macro file/macro name"

The /M specifies the macro command

The ,E specifies that after execution of the macro, the file should be saved and the editor exit, this is an optional parameter.

The ,5 specifies the number of times the macro should run.  This is an optional parameter, and if not present the macro will run once if a file is loaded on the command line.  If a file is not specified on the command line the macro will not run unless the number of times is specified.

The macro filename is specified in  quotes.  Optionally, the name may include a forward slash (/) followed by the name of the macro if the file contains more than one macro.  If a macro name is not specified, the first macro in the file will be used.


Page Setup
Page Setup (File menu)

The Page Setup menu item presents a dialog allowing the user to set up page headers, footers and margins for printing.  The page header, if setup, is printed at the top of every page.  The page footer, if setup, is printed at the bottom of every page.  If a page footer or header is setup, a single line is printed across the page between the header or footer and the text to be printed.

The header or footer may be disabled by selecting the appropriate check box.  If the header or footer is enabled, the separator line that is normally printed between the header/footer and the page text may optionally be disabled.

The page header and footer may include text defined by the user, and additionally special characters to allow the filename, and page numbers to be printed in the header or footer.

The special characters are:

&f 	This is replaced in the header or footer with the full filename including path.

&n 	This is replaced in the header or footer with the filename only (no path).

&p 	This is replaced in the header or footer with the page number.

&t 	This is replaced in the header or footer with the total number of pages.

&l 	This aligns the text following the "&l" to the left side of the header/footer area.

&c 	This aligns the text following the "&c" to the center of the header/footer area.

&r 	This aligns the text following the "&r" to the right side of the header/footer area.

(Note - the alignment characters are not required, and any or all of them may appear in a single header or footer.  However, if more than one is present, they must be in the order above ("&l" must be before "&c" and "&c" must be before "&r").

Additionally,  the header or footer may include the file date and time or system date and time.  Two radio buttons allow the selection of either the file date, or the system date to be included in the header or footer.  The radio buttons select the source of the date and time,  additional special characters used in the header or footer specify if the date and time are to be printed and what format is used.

The characters used to specify the time and date format are shown below,  the absence of any of these characters result in the time and date not being printed.

The formatting codes date and time  are listed below:

Format	Description
%a	Abbreviated weekday name
%A	Full weekday name
%b	Abbreviated month name
%B	Full month name
%c	Date and time representation appropriate for the locale
%d	Day of the month as a decimal number (01-31)
%H	Hour in 24-hour format (00-23)
%I	Hour in 12-hour format (01-12)
%j	Day of the year as a decimal number (001-366)
%m	Month as a decimal number (01-12)
%M	Minute as a decimal number (00-59)
%p	Current locale's AM/PM indicator for a 12-hour clock
%S	Second as a decimal number (00-59)
%U	Week of the year as a decimal number, with Sunday as the first day of the week (00-51)
%w	Weekday as a decimal number (0-6; Sunday is 0)
%W	Week of the year as a decimal number, with Monday as the first day of the week (00-51)
%x	Date representation for current locale
%X	Time representation for current locale
%y	Year without the century as a decimal number (00-99)
%Y	Year with the century as a decimal number
%Z	Time zone name or abbreviation; no characters if time zone is unknown
%%	Percent sign

Examples:

Date is July, 4th 1994.  Time is 9:00pm

"%X , %x" prints 	"21:00 , 07/04/94"

Date is July, 4th 1994.  Time is 9:00pm

"%c" prints	07/04/94 21:00

Date is Jan, 10th 1991.  Time is 5:00am

"%A, %B %d, %Y %I:%M%p" prints 	Tuesday, January 10, 1991  05:00:am

Page Margins

The page margins may be set up in either inches or millimeters (mm).  Each margin, top, bottom, left and right may be set independently.  The margins are applied before the headers and footers are generated.  If the printer is set up to have a minimum margin that is greater than the margin selected in UltraEdit the printer margin will be in effect.

Page Break Character

The page break character may be set to any ASCII character.  The page break character defaults to a form-feed character ,12 (0C HEX).  This character may be changed if required but should not be set to any printable character as a page break will be inserted on every occurrence of this character when printing occurs.  It may be desirable to change this character if the font being used does not allow the page break character to be seen.

Wrap Text When Printing

This option when set will automatically cause the printed output to wrap the text to additional lines of any line that exceeds the width of the printable area of the page.

Print Line Numbers

This option when set causes the line numbers to be printed for each line on the left hand side of each page. If a line is wrapped, the line number is printed with the first line only.  This setting is independent from the Display Line Number setting.

Print 2 Pages on 1 Sheet

This option allows two logical pages to be printed on a single sheet of paper.  The logical page data is scaled to print two pages side-by-side.  This scaling may mean that a little more or less data may fit side-by-side than when the pages are printed on a single sheet.

This option is particularly useful for saving paper on printouts.

Print Syntax Highlighting

This option instructs UltraEdit to print the file with the color used for syntax highlighting if a color printer is used.  This will also show shades of gray on a Postscript monochrome printer.


Goto
Goto Line/Page (Search menu)

The Goto menu item presents a dialog that allows the user tospecify the line or page break at which the cursor should be positioned.  The cursor is positioned at the line specified and the line is scrolled into view.  If the line number is greater than the number of lines in the file, the cursor is positioned at the end of the file.

When Page Break is specified, the cursor is positioned at the line with the specified page break character.

When the Shift Key is pressing at the same time as performing the Goto function the current selection (if present), or a new selection will be extended to select text up to the cursor position following the command.

In HEX mode the goto dialog allows the user to select the offset into the file at which the cursor should be positioned.  If the offset is greater than the file size, the cursor is positioned at the end of the file.

Shortcut

Keys:	CTRL+G


Page Breaks
Insert Page Break (Format menu)

The Insert Page Break menu item inserts a page break character at the current cursor position.  The page break character can be configured in the Page Setup dialog.

When the document is printed,  the page break character is replaced with a page break.  Printing continues on the next page following a page break character.


Keyboard Commands

UltraEdit allows the use of keyboard commands for a number of commonly used features.  The keyboard commands are listed below:

F1	Help	Show UltraEdit help
Shift+F1	Context Help	Invoke the context help command and cursor.
Ctrl+N	File New	Create a new document file
Ctrl+O	File Open	Open an existing document file
Ctrl+F4	File Close	Close an existing document file
Ctrl+S	File Save	Save the active document
F12	File Save As	Save the active document as a new file
Ctrl+P	File Print	Print the active document
Ctrl+X	Edit Cut	Cut text from the document into the clipboard
Ctrl+C	Edit Copy	Copy text from the document into the clipboard
Ctrl+V	Edit Paste	Paste text from the clipboard into the active document
Ctrl+A	Edit Select All	Select All the text in the active document
Ctrl+Z	Edit Undo	Undo the last action if possible
Ctrl+Y (previously Ctrl+A)	Edit Redo	Reverse the last Undo action if possible
Ctrl+J	Edit Select Word	Select the current word (same as double click).
Ctrl+E	Edit Delete Line	Delete line the cursor is on
Ctrl+F11	Edit Delete to Start of Line	Delete from the cursor to start of line
Ctrl+F12	Edit Delete to End of Line	Delete from the cursor to end of line
F7	Edit Insert Time/Date	Insert time/date at cursor
Alt+F3 or Ctrl+F	Edit Find	Find a character string
Ctrl+F3	Find Prev	Repeat last find toward beginning of file
F3	Find Next	Repeat last find toward end of file
Ctrl+B	Match Brace	Find matching brace (,[,{ or },],)
Ctrl+R	Replace	Find and replace a character string with another
Ctrl+G	Goto	Goto the specified line (or HEX address)
Ctrl+T	Edit Reformat Paragraph	Reformat the current paragraph or selected text
Ctrl+F5	Format To Lower	Convert selected text to lower case
ALT+F5	Format To Upper	Convert selected text to Upper case
F5	Format Capitalize	Capitalize first character of each word in selected text
Shift+F5	Format Invert Case	Invert case of all characters in selected text
Ctrl+K	Edit Spell Check	Invoke the spelling checker
ALT+C	Column Mode	Toggle column/block mode on and off
Ctrl+Backspace	Delete previous word	Delete the word preceding the cursor
Ctrl+Delete	Delete next word	Delete the word following the cursor
Ctrl+I	Insert Literal Character	Insert a literal character at the cursor position
INS	Insert/Overstrike Mode	Toggle between Insert and Overstrike mode
Ctrl+H	HEX Edit	Toggle HEX editing mode
Ctrl+D	HEX Insert/Delete	Insert or delete characters in HEX editing mode
Ctrl+F2	Set Bookmark	Toggle bookmark on and off
F2	Goto Bookmark	Goto next bookmark
Ctrl+M	Macro Play	Replay a macro
Ctrl+L	Macro Play Multiple Times	Replay a macro the specified number of times
Ctrl+F6	Next Window	Make the next document window active
Ctrl+Shift+F6	Previous Window	Make the previous document window active
Alt+F4	Exit UltraEdit	Exit UltraEdit
Alt+0-9 Shift+Alt+0 - 9	Insert Template0	Insert user defined template
F9	DOS Command	Run DOS Window command
Ctrl+F9	Last DOS Command	Repeat last DOS Window command
F10	Execute Window Program	Execute Windows Program
Ctrl+Shift+A	Inserts ä character
Ctrl+Shift+A	Inserts Ä character (Caps Lock on)
Ctrl+Shift+O	Inserts ö character
Ctrl+Shift+O	Inserts Ö character (Caps Lock on)
Ctrl+Shift+U	Inserts ü character
Ctrl+Shift+U	Inserts Ü character (Caps Lock on)
Ctrl+Shift+S	Inserts ß character
Ctrl+Shift+S	Inserts ß character (Caps Lock on)
Ctrl+Up	Scroll Up	Scroll up one line keeping cursor in view
Ctrl+Down	Scroll Down	Scroll down one line keeping cursor in view
F4	Change focus	Toggle focus between active file and Tree View if shown
F8	Display Function List	Display Function List
Alt+Right Arrow	Next Paragraph	Position cursor at first not space character of next paragraph
Alt+Left Arrow	Previous Paragraph	Position cursor at first not space character of current paragraph (if positioned mid-paragraph) or previous paragraph
Alt+Page Up	Top of Window	Position cursor beginning of first line in of the display
Alt+Page Down	Bottom of Window	Position cursor beginning of last line in of the display


Fixup CR/LF
UNIX/MAC to DOS (File menu)

Use this command to correct the end of line characters for display in UltraEdit and other text editors.

Some documents generated from UNIX based systems (and some other systems) do not terminate each line with a carriage return and linefeed.  UltraEdit requires all lines to be terminated with a carriage return and linefeed character.

This command searches the file for all carriage return and linefeed characters.  If a carriage return character is found without an accompanying linefeed character, a linefeed character is added.  If a linefeed character is found without a preceding carriage return character a carriage return character is inserted.  If a linefeed is found preceding a carriage return the characters are reversed.

To convert a file to UNIX format, use the DOS to UNIX command.

To convert a file to MAC format, use the DOS to MAC command.


To Upper Case
To Upper Case (Format menu)

This command changes all selected text to upper case.  There is no limit on the amount of text that may be selected.  If Column Mode is selected, the selected columns only are converted.

Shortcut

Keys:	ALT+F5


Invert Case
Invert Case (Format menu)

This command inverts the case of all selected text.  There is no limit on the amount of text that may be selected.  If Column Mode is selected, the selected columns only are converted.

Shortcut

Keys:	SHIFT+F5


To Lower Case
To Lower Case (Format menu)

This command changes all selected text to lower case.  There is no limit on the amount of text that may be selected.  If Column Mode is selected, the selected columns only are converted.

Shortcut

Keys:	CTRL+F5


Capitalize
Capitalize (Format menu)

This command changes the first letter of all words in the selected text to upper case and the remaining letters to lower case.  There is no limit on the amount of text that may be selected.  If Column Mode is selected, the selected columns only are converted.

Shortcut

Keys:	F5


Mouse Commands
Right Mouse Button Commands

UltraEdit allows the right mouse button to display a pop-up menu.

If the right mouse button is clicked while in a document window, the Edit Menu is displayed at the position of the mouse click.  If text is selected when the right mouse button is pressed, a new menu item Open File Highlighted is added to the top of the pop-up menu and if selected the file is opened if it exists.

If no text is selected, UltraEdit will examine the text under the cursor and if it finds what it believes may be a file it will add a new menu item "Open " followed be the name of the file it will try and open.  If this is a URL the information will be passed to the default browser for opening.

If the right mouse button is clicked while in the UltraEdit main window and outside of a document window, the File Menu is displayed at the position of the mouse click.


File Insert command
Insert File (File menu)

Use this command to insert an existing document (file) into the active document.

This command presents a dialog allowing selection of the file to insert.  The complete contents of the selected file is inserted in the active document at the cursor position.


Convert CR/LF's to Wrap command
Convert CR/LF's to Wrap (Format menu)

Use this command to remove the CR/LF (carriage return/line feed) characters from the file allowing the text to be Word Wrapped by UltraEdit.  This feature removes all CR/LF characters for text that is selected.  If no text is selected this function has no effect.

To remove all CR/LF characters from the file select the complete file.  To do this, position the cursor at the beginning of the file and press CTRL+SHIFT+END at the same time.

To add CR/LF (carriage return/line feed) characters to the file use the

Convert Wrap to CR/LF's command.


Trim Trailing Spaces
Trim Trailing Spaces (Format menu)

Use this command to remove the trailing white space (tabs, spaces) from the ends of each line.  This function removes the trailing white spaces from the end of every line in the file and positions back to the original cursor position when it is complete.

The General Configuration page provides a setting allowing spaces to be trimmed automatically when a file is saved.


Convert Wrap to CR/LF's command
Convert Wrap to CR/LF's (Format menu)

Use this command to Word Wrap the text based on either the width of the display window or a specified column number and write CR/LF (carriage return/line feed) characters to the file.  If a space is found at the position of the wrap a single space is removed.  This allows the document to be saved as viewed in the word wrap state with CR/LF characters inserted at the end of each word wrapped line.

When this item is selected, a dialog box is displayed allowing selection of the wrap parameters.  By default, the text will be wrapped based on the current view.  That is to say, the text will be wrapped at the window boundary as shown on the screen.  This dialog allows selection of a column number at which the text should be wrapped.  In this case the text will be wrapped at the specified column or at the preceding word boundary on the line.

This feature works on the complete file if no text is selected.  If a selection is made, the feature only converts the selected area.

To remove CR/LF (carriage return/line feed) characters from the file use the Convert CR/LF's to Wrap command.

:


Multiple Instances
Multiple Instances (General Configuration Page)

The Multiple Instances menu item determines if UltraEdit opens another instance of UltraEdit if it is invoked when a copy is already active.  If this option is enabled, a new instance is opened each time UltraEdit is invoked.  If this option is not enabled, only a single instance of UltraEdit is opened, and any additional requests result in the first instance becoming active with the new file loaded in addition to any files already open.


File Save All command
Save All command (File menu)

Use this command to save all modified documents to its current name and directory.  When you save a document for the first time, UltraEdit displays the Save As dialog box so you can name your document.  If you want to change the name and directory of an existing document before you save it, choose the Save As command.


Column Mode
Column Mode (Column menu)

This command changes the operation of the editor for selecting text.  When column mode is selected highlighted text is based on the character column position of the first character selected to the column of the last character of text selected.  Text selected in this mode does not automatically include all text between the start and end position, but includes all text in the columns between the first and last character selected.

Column mode editing is sometimes referred to as block mode editing as the act of selecting text forms a rectangle.

Cut, Copy and Paste work with the selected text.

Column mode editing requires the Word Wrap be turned off and a fixed pitch font be selected.

When column mode is enabled, additional column features are enabled; Insert/Fill Columns, Delete Columns, Cut Columns and Insert Number.

Shortcut

Keys:	ALT+C


Column Insert/Fill
Insert/Fill Columns (Column menu)

This command presents a dialog that allows a text string to be entered.  This text will be inserted into every line that is selected, or if no selection is made it will be inserted into every row starting at the current cursor position and proceeding to the last row of the file.  The text string will be inserted into every row at the column position indicated by the cursor when this command is invoked.  If text does not exist at this column in any row, spaces ' '  will be added to pad the row allowing the text to be inserted correctly.

If at the invocation of this command, text is highlighted, the columns indicated by the highlighted text will be replaced with the specified text.


Column Delete
Delete Columns (Column menu)

This command presents a dialog that allows the number of columns to be deleted to be specified.  The columns will be deleted from every line that is selected, or if no selection is made they will be deleted from the file from every row starting at the current cursor position and proceeding to the last row of the file.  If a value of zero '0' is entered, columns will be deleted based on the highlighted text when this command is invoked.  This command does not save the deleted text in the clipboard.


Column Cut
Cut Columns (Column menu)

This command presents a dialog that allows the number of columns to be cut to be specified. The columns will be removed from every line that is selected, or if no selection is made they will be removed from the file from every row starting at the currentcursor position and proceeding to the last row of the file.  If a value of zero '0' is entered, columns will be removed based on the highlighted text when this command is invoked.  This command saves the removed text in the clipboard.


Column Insert Number
Insert Number (Column menu)

This command allows a sequential number to be inserted into every line selected, or if no lines are selected, into every line at the column position indicated by the cursor.  This command presents a dialog that allows the initial value to be entered and the increment for each line.  This provides an easy method to add line numbers into a text file.

If any text is highlighted at the invocation of this command, the highlighted text will be replaced by the inserted line numbers.  The spacing required for the line numbers is calculated automatically based on the number of lines that will have a number inserted, the initial value and the increment.  All numbers may be positive or negative non decimal point numbers.

If the option to add "Leading Zeros" is selected the appropriate leading zeros will be be added to each number to pad the field to the same width (in characters) as the maximum number to be inserted.  If this option is not selected, trailing spaces will be used.


Find In Files Command
Find In Files command (Search menu)

This command displays a dialog box for searching for a text string in files on a disk.

The string to search for is specified in the Find field.  The files to search are specified in the InFiles/Types and Directory fields.  The directory field specifies the directory to search and the InFiles/Types field specifies the filename or types.  The filename may contain wildcards and may also contain multiple file types separated by semicolons, i.e.:

*.cpp;*.h

The following search options exist:

Search In:

Files Listed - This will search the files listed in InFiles/Types and Directory fields (default selection).

Open Files - This will search all open files.  The InFiles/Types and Directory fields  will be ignored.

Project Files - This will search all files within the open project.  The InFiles/Types and Directory fields  will be ignored.

Match Case

By default, the search will not be case sensitive. The option to make the search case sensitive is given.

Match Whole Word Only

By default, the search will not be restricted to matching whole words only. This option allows the search to be restricted to whole words only. This is useful forsearching for ' a ', or 'A' without finding all words including 'a'. If a search has already occurred in a document, the default selection will match the previous search.

Search Sub directories

By default, only files specified in the specified directory are searched.  This instructs the search to search all sub directories of the specified directory.

Results to Edit Window

This option instructs UltraEdit to create an edit window (new file) for the results of the find.  This allows editing of the results and saving the results.  The default action is to capture the output in a list box window (Output Window) that allows the user to double click on the result and have the file opened automatically.

Regular Expressions

  See Regular Expressions.

When the find is executed, a new file window is opened (if it does not already exist) with the title "Find Results".  This windows is updated with each occurrence of the found string and the line number of the file in which it was found.  This window maybe saved, printed, or edited in the same manner as any file.

Successive finds update an existing "Find Results" window if it already exists, or creates a new window if it does not.  If the window already exists, results are appended to the end.


Find In Files Command
Replace In Files command (Search menu)

This command displays a dialog box for searching for a text string in files on a disk and replacing it with another text string.

The string to search for is specified in the Find field.  The files to search are specified in the InFiles/Types and Directory fields.  The directory field specifies the directory to search and the InFiles/Types field specifies the filename or types.  The filename may contain wildcards and may also contain multiple file types separated by semicolons, i.e.:

*.cpp;*.h

The following search options exist:

Match Case

By default, the search will not be case sensitive. The option to make the search case sensitive is given.

Match Whole Word Only

By default, the search will not re restricted to matching whole words only. This option allows the search to be restricted to whole words only. This is useful for searching for ' a ', or 'A' without finding all words including 'a'. If a search has already occurred in a document, the default selection will match the previous search.

Search Sub directories

By default, only files specified in the specified directory are searched.  This instructs the search to search all sub directories of the specified directory.

Regular Expressions

  See Regular Expressions.

When the find/replace is executed, each file where the find string is found is modified and each occurrence of the string is replaced with the replace string.  If the file is read-only, the file is not modified and a message box is posted.  At the end of the operation, a dialog box is displayed indication how many times the replace occurred and how many files were modified.


General Configuration Items
General Configuration Page

The general options page has the following selections:

Multiple Instances	If checked, allow multiple instances of UltraEdit.
Project Menu on Main Menu	Enables the Project Sub-Menu on the Main Menu Bar.
Recent Files List on File Menu	Enables the Recent File List on the File Menu directly rather than as a sub-menu.
Number of Recent files	Set the number of recent files that appears on the file menu for quick opening of file.
Number of Hex Characters/Line	Defines the number of hex characters to be shown in each line of the display.
Disable Line Numbers	Disables line number display. This improves speed on large files.
Open File Without Temp File	Open file without creating temporary file (all changes are permanent).
Minimize on last file close	If checked, UltraEdit will minimize when all open files are closed.
Minimize to System Tray	If checked, UltraEdit will minimize and to the System Tray and NOT to the task bar.
Always on top	If checked, UltraEdit will be set to always be the top window.
Save Bookmarks	Save bookmarks when file is closed.
Disable File Change Detection	Disable the detection of files changed outside of the editor.
Auto Update Changed Files	Auto update files that have changed outside the editor.
Auto Detect Unix Files	This option instructs UltraEdit to automatically detect Unix files when opened and ask if they should be converted.
Auto Convert Unix Files	This option instructs UltraEdit to automatically detect and convert Unix files when opened.
Save File as Input Format	This option instructs UltraEdit to automatically save the file as the original format (Unix/Mac) when saved unless it was manually converted after opening.
Default to Read Only	This option determines if the file is opened as Read-Only by default.
Reload Open Files on Startup	Remember the files that were open from last session and reload them on start up.
Use Default DirOn File Open	Use the default directory for the file open..
Use Active File Dir. On File Open	Use the directory for the active file for the file open..
Left Delimiters for Ctrl+Dbl Click	Configure delimiter characters for text selection with Ctrl+Mouse Left Button Double Click.
Right Delimiters for Ctrl+Dbl Click	Configure delimiter characters for text selection with Ctrl+Mouse Left Button Double Click.
Trim Trailing Spaces on Save	Automatically trim trailing spaces when a file is saved.


File Type Configuration
File Type Configuration Page

This page allows the list of file types that appear in the File Open and File Save As dialog boxes to be configured.  Up to 10 file types may be configured.  These file types will be shown in the file operation dialog boxes in the same order they are shown on this page.

Each file type configured consists of a filename and file description.  The filename may (and probably does) include wildcard characters and may include multiple file extensions each separated by a semicolon  ";"(i.e. "*.c;*.cpp").  The file description is a text field describing the file types.

This dialog also provides a DEFAULT button that resets the file types to the initial settings.


DOS to UNIX conversion
DOS to UNIX (File menu)

Use this command to convert the file to a UNIX format.  This will replace the carriage return and line feed combinations to a line feed only.

To convert a file from UNIX or MAC format, use the UNIX/MAC to DOS command.


DOS to MAC conversion
DOS to MAC (File menu)

Use this command to convert the file to a Macintosh format.  This will replace the carriage return and line feed combinations to a carriage return only.

To convert a file from UNIX or MAC format, use the UNIX/MAC to DOS command.


OEM to ANSI conversion
OEM to ANSI (Format menu)

Use this command to convert a file that uses the OEM character set (usually DOS generated text files) to the ANSI (Windows) character set.

To convert a file from ANSI to OEM, use the ANSI to OEM command.


ANSI to OEM conversion
ANSI to OEM (Format menu)

Use this command to convert a file that uses the ANSI (Windows) character set to the OEM (DOS) character set.

To convert a file from OEM to ANSI, use the OEM to ANSI command.


Syntax Highlighting

Syntax highlighting is the ability to recognize predefined words and display them in a different color(s).  This is particularly useful for programmers, and can also be useful to other users who may want certain words in a document to show up in a different color.

UltraEdit provides support for ten languages or word sets that may be recognized.  Each word set may be configured to have a different color for the following groups of words:

Normal Text (Words that are not recognized)

Words that appear in a comment line, or block comments

Alternate set of block comments

Strings

Number values (must start with a digit (0-9))

Up to eight groups of different recognized words

The Configuration Dialog allows the colors to be selected for the different language and color groups.  This also allows the user to specify the location of the "wordfile" used for highlighting.

For any of the color groups the foreground/text color and the background color may be set.  By default the background will revert to the background specified for normal text (Background Color Automatic will be checked).  This must be unchecked to activate the background color.

Each color may be changed by clicking on the colored box beside the text description.  When clicked, a dialog box will appear that allows the new color to be selected.

Additionally for each color group (except Normal Text) font styles of Bold, Italic and Underline are available.  These may be selected individually for each color group.  With some fonts the underline may not always show correctly, and with bold, the spacing may not be correct for non-fixed pitch fonts.

The Auto-Correct Keywords checkbox enables or disables the Auto-Correct feature.

Note - The highlighting is determined by the file extension (details below).  The file extension of the file being modified must be defined in the "wordfile" for one of the languages.

The predefined words may be configured by the user as follows:

UltraEdit reads a configuration file (the default file is "WORDFILE.TXT"), to configure the syntax highlighting.  This file is read each time the editor starts up.  The size of this file may be up to 128KB.  The syntax for this file is as follows:

Language Definition

The word set, or language is specified by a /Ln where n has a value of 1 to 10.  This must be at the beginning of the line.  A description or name of the language may be specified immediately following the /Ln in quotes.  This description if present is displayed when setting up the colors for the language.  The description may be up to 18 characters.

Line Comments

The comment characters used for line comments is specified by the string "Line Comment = "  followed by the comment characters.  Three characters are allowed, if there is less than three then the last character must be followed by a space.

A second set of line comments may be specified by the string "Line Comment Alt = "  followed by the comment characters.  Three characters are allowed, if there is less than three then the last character must be followed by a space.

As some instances may require that a space is a part of the line comment an alternative method to describe the line comment is available.  Using the alternative method, the number of characters used is specified by the user with the following syntax:

"Line Comment Num = xCC "

where x specifies the number of characters (1 to 3) and IMMEDIATELY following are the characters to be used as line comments.  In the example above, x would be 3, and the line comment would be CC  (note the space after CC).

Block Comments

The characters used for block comments may also be configured (i.e. /* … */ for C).  These are in the form "Block Comment On = " and "Block Comment Off = " followed by up to five characters each that define the comment designators.  For compatibility with previous releases, the /* and */ are used for file types that have .C as one of the extensions.  This may be overridden.  The first character of the block comments may be a space.

If a Block Comment On is defined but the Block Comment Off is not defined the commenting will stop at the end of the line.  This effectively allows the block comments to be used as line comments also.

Additionally, a second set of block comments may be defined for languages that require it.  This is particularly useful for ASP allowing HTML comments to be maintained with the addition of adding highlighting for ASP blocks.

The second set of block comments are in the form "Block Comment On Alt = " and "Block Comment Off Alt = " followed by up to five characters each that define the comment designators.  The first character of the block comments may be a space.

If a Block Comment On is defined but the Block Comment Off is not defined the commenting will stop at the end of the line.  This effectively allows the block comments to be used as line comments also.

File Extensions/Types

The file extensions that are applicable for this language are specified by the string "File Extensions = " and each extension is separated by a space.

Color Selection

Color codes may be specified by adding a line with /Cn at the beginning of the line, where n is the color index of 1 to 8.  A description or name of the section may be specified immediately following the /Cn in quotes.  This description if present is displayed when setting up the colors for the language.  The description may be up to 18 characters.

All information specified remains in effect until overridden with new command information.

The following example specifies the first language to be used with files with the extensions 'C', 'CPP', 'H' or 'HPP'.  The color used for the words is the first selectable color and the comment characters are //.

/L1"C/C++" Line Comment = // Block Comment On = /* Block Comment Off = */ File Extensions = CPP C H HPP

/C1

auto

break

case char const continue chr$

default do double

Case Sensitivity

If the language is not case sensitive, the keyword Nocase may be added to the command line i.e.:

/L1 Line Comment = // Nocase File Extensions = CPP C H HPP

Strings

When using many programming languages, characters in single quotes and double quotes are treated as literal strings, and word and comment recognition should be ignored.  This is the default behavior for UltraEdit.  There are some languages, (i.e. HTML and others) where this behavior is undesirable.  To facilitate such languages the keyword "Noquote" may be added to the command line to override the default behavior i.e.:

/L1 Noquote File Extensions = HTM

UltraEdit now supports configurable characters for quotes strings.  The default characters for strings are single and double quotes (') and (").  These may be overridden with the keywords "String Chars = " followed by up to two characters.  This is only required if you wish to use different characters from the default.  If for example you wish to use the double quote only for strings you would have a line similar to the following:

/L1"C/C++" Line Comment = // Block Comment On = /* Block Comment Off = */ String Chars = " File Extensions = CPP C H HPP

Note the "String Chars" portion.

Additionally, if you have two characters for the strings defined (or using the defaults) and you wish to have a different color for each type of string, you may now include the character (i.e. double quote) in one of the color groups in a line by itself.  This will override the configurable color for the strings that are encapsulated by this character.

/L1"C/C++" Line Comment = // Block Comment On = /* Block Comment Off = */ String Chars = '" File Extensions = CPP C H HPP

/C1

auto

break

"

…

In the above example, all strings that have double quotes (") around them will be colored with the color group C1 while strings with a (') around them will use the default color for strings.

Escape Character

In many languages there is a special designated character that is referred to a an Escape Character.  This is used to override the normal string characters (and other characters).  If a string is defined that itself contains a quote character normally used to define the string, the syntax highlighting would interpret this quote as the end of the string.  If however this quote character is preceded with an Escape Character the quote character would be appropriately treated as part of the string and not the end of it.

The Escape Character is defined as follows:

/L1"C/C++" Escape Char = \ …

In this case the Escape character is defined as a backslash.

Keywords

Note that ALL words starting with the same character may be on the same line or spread across multiple lines, however if they are spread across multiple lines the lines must be one after the other with no empty lines or other line lines between them.

If the language is case sensitive, the letter 'A' is different from 'a' and so words starting with 'A' MUST be on a different line from words starting with 'a'.  If the language is case insensitive words starting with the letter 'A' must be on the same line as words starting with the letter 'a'.

Keywords beginning with a Sub String

There are instances in some languages where it is desirable to highlight keywords that begin with a particular sub-string, however the complete word is not known.  UltraEdit provides the ability to define sub-strings that are used to determine if a word should be highlighted.  If such sub-strings are defined for a particular language under a color group UltraEdit will determine if a word begins with one of the sub-strings.  If it does, it will be highlighted accordingly.

The sub-strings should be defined as with any other set of keywords however the line containing the sub-strings should start with "** " and all sub-strings should be on the same line as in:

** aaa bbb

The example above would highlight any words beginning with "aaa" or "bbb".

Words Starting with '/'

As UltraEdit uses '/' as a command character words to be highlighted require special handling.  To highlight words beginning with a '/' the line should begin with '// ' followed by the keywords as in:

// /mykeyword /anotherkeyword

HTML Specific

HTML is considerably different from other languages, and to better facilitate the use of UltraEdit for editing HTML files the "HTML_LANG" keyword was added.  When this keyword is present, the special characters '<' and '/' may be placed in front of any keyword as desired without all keywords with the special ('<' and '/') characters all having to be on the same line.  In this case, words starting with the same letter (a-z etc) must be on the same or contiguous lines as is normally required.

Below is an example portion of a word file for HTML:

/L3"HTML" Line Comment = // HTML_LANG Block Comment On = <!-- Block Comment Off = --> File Extensions = HTM HTML

/C1

<A </A> <ADDRESS> </ADDRESS> <APPLET </APPLET>

<B> </B> <BASE <BASEFONT <BGSOUND <BIG> </BIG> <BLINK> </BLINK> <BLOCKQUOTE> </BLOCKQUOTE>

<CAPTION> </CAPTION> <CENTER> </CENTER> <CITE> </CITE> <CODE> </CODE>

Additional enhancements for HTML will be added in the future.

FORTRAN Specific

FORTRAN is quite different from other languages regarding comments, and to better facilitate the use of UltraEdit for editing FORTRAN files the "FORTRAN_LANG" keyword was added.  When this keyword is present, UltraEdit treats a 'C', 'c' or '*' in the first column as a line comment indicator and the rest of the line is highlighted as if it were commented out.

Below is an example portion of a word file for FORTRAN:

/L4"Fortran" FORTRAN_LANG File Extensions = FOR FTN

/C1

…

Note- any of the normal comment indications may also be used (line comments, block comments).

LaTex/Tex Specific

TeX/LaTeX is quite different from other languages and each command starts with a '\'.  To better facilitate the use of UltraEdit for editing TeX/LaTeX files the "LATEX_LANG" keyword was added.  When this keyword is present, UltraEdit has special handlingfor syntax highlighting to allow words to be appropriately handled and highlighted with the '\', and with consecutive words.

This also allows the recognized words to be placed in the wordfile without all of them being on the same line.  If the word begins with '\' then the second character is used to determine which line the word should be on.  All words beginning with '\a' should be on the same line as other words beginning with '\a' or 'a'.  In the same way, all words beginning with '\b' should be on the same line as other words beginning with '\b' or 'b' but on a different line from those starting with '\a' etc.

Below is an example portion of a word file for TeX/LaTeX:

/L4"TeX/LaTeX" LATEX_LANG File Extensions = TEX LATEX

/C1

…

Note- any of the normal comment indications may also be used (line comments, block comments).

Delimiters

UltraEdit has built in delimiters that are used to determine when a new word starts, and when a word finishes so that it may be matched against the set of words for a given language.  With the exception of the '<' and '>' characters in HTML a character that is a delimiter may not also be part of a word; that is, you can not say the @ symbol is to be considered part of a word, and it is a delimiter between words.  (Future enhancements may allow this).

With release 4.1 and later, UltraEdit allows the delimiter characters to be configurable by the user.  For compatibility, the existing delimiters are retained if the user does not specify the delimiters for a given language.  Each language may have its own set of delimiters.  It is not necessary to configure the delimiters for languages if you are using the defaults.

To specify the delimiters, add a NEW line similar to the following to your wordfile:

/Delimiters = ~!@$%^&*()_-+=|\/{}[]:;"'<> ,.?/

Note that the Delimiters should include a space and a TAB character if you want them to be considered delimiters.  The line must begin with "/Delimiters =".

With release 5.0 it is possible to assign the delimiter characters to the color sections.  If you have a character that is a delimiter, such as a '+' and you wish this to be colored with one of the group colors you may add this character to a line of its own under the color section and this will retain its recognition as a delimiter and be highlighted with the appropriate color.

Function Definition Strings

UltraEdit allows the user to show a list of functions in the active document.  As the definition of a function may be different for different languages it is necessary to allow this to be configured based on the language.

This is accomplished by modifying the "wordfile" and defining the string UltraEdit uses for each language.  The string will be used by UltraEdit as a Regular Expressions search string to find the functions.

Note - The regular expression string must use UltraEdit style regular expressions.  This ensures that the function list will always work irrespective of the regular expression settings.

To specify the function string add a line similar to the following for the specific language:

/Function String = "%[a-zA-Z]*)"

This string to be searched for MUST be in quotes.  If required, you can specify that only part of the resultant string is displayed in the function list.  To do this, use the tagged expressions as defined under the Regular Expressions and enclose the portion of the expression that is to be displayed between "^(" and "^") as in:

/Function String = "%[a-zA-Z]+^(*^))"

This example would ignore the first word and display the rest of the line.

Indentation

UltraEdit provides for automatic indentation based on the specific language to indent a block of code or to out-dent a block of code.

For indentation for a specific language add a line similar to the following line under the particular language section:

/Indent Strings = "{"

Any number of words may be specified in quotes (each word/string must be in a separate set of quotes "").  For the word to match it must be the LAST non space characters of the line.  The indentation is the next TAB stop from the indentation of the preceding line (same as if a TAB key was pressed).

For out-denting for a specific language add a line similar to the following line under the particular language section:

/Unindent Strings = "}"

Any number of words may be specified in quotes (each word/string must be in a separate set of quotes "").  For the word to match it must be the FIRST non space characters of the line.  If the line that contains the string is indented LESS than the preceding line an indentation does not occur, otherwise the matching character/word is out-dented to the preceding TAB stop and the new line is indented to the same point.

Marker Characters

There are times when it is desirable to highlight all characters between two characters.  UltraEdit provides for marker characters that mark the first and last part of a string that UltraEdit highlights between.  All characters between the two characters are highlighted.

To define marker characters for a specific language add a line similar to the following line under the particular language section:

/Marker Characters = "ab"

where a is the first character of the string to be highlighted and b is the last character.  Note that all characters on a line will be highlighted including spaces.  If the line is a comment or string this is ignored.

Additionally, you may define up to 4 pairs of characters to highlight between as in:

/Marker Characters = "abcdefgh"

where strings starting with 'a' and ending with 'b' are highlighted as are strings starting with 'c' and ending with 'd' etc.

The color of the highlighted string is configurable.  To specify the color, add the two characters under the appropriate color section as if they were a word such as "ab", "cd" etc.

This file may be modified by the user.


Spell Checker
Spelling Checker (Edit Menu)

UltraEdit incorporates a 100,000+ word spelling checker.  The spelling checker is invoked from the Edit Menu and will check the complete file if text is not selected, or if text is selected it will check the selected text.

If a word is not found in the selected dictionary the Check Spelling Dialog is displayed with various options that allow the word to be changed, ignored, or added to a user dictionary.

The new spelling checker supports different languages.  These languages are selected from the Spell Checker Options configuration page.


Send Mail command
Send Mail command (File menu)

Use this command to send the active file as a MAIL attachment.  The file, and all changes are sent.  This feature is only supported on systems that have MS-MAIL installed, or another mail program that installs itself with MAPI support.


Reformat Paragraph command
Reformat Paragraph command (Format menu)

Use this command to format the current paragraph (or selected text) to the specified column number boundary.  The column number is specified in the Advanced Configuration (Edit) page.  A paragraph is determined as having two hard returns in succession (i.e. a blank line).

All hard returns are removed for the paragraph, and the paragraph is reformatted to the appropriate column boundary.

The whole file may be reformatted using the Select All command to first select the complete file, then reformat it.

If the Auto Indent feature is enabled the paragraphs will be automatically indented based on the first line of the paragraph.

The settings used in the Paragraph Reformatting dialog will be used for this command.


Paragraph formatting commands
Paragraph Formatting (Format menu)

The paragraph formatting allows the user align the paragraph in the following manners:

Left Align 	Text will be left aligned against the left margin and will not extend past the right margin.

Center Align	Text will be centered between the left and right margins.

Right Align	The text will be right aligned against the right margin and will not extend past the left margin.

Fill	The text will be aligned between the right and left margins with spaces added between words to ensure alignment to both margins.  The last line of the paragraph will be aligned only to the left margin.

Each of the separate alignment commands may be selected individually from the menu, or invoked from the Paragraph Setup/Reformatting dialog.

The Paragraph Setup/Reformatting dialog specifies the parameters used for reformatting.  These parameters are used when one of the paragraph formatting commands are used.

The parameters are:

Hanging Indent	This applies to the left alignment only.  If set, the alignment will allow a second margin to be specified that is used for the second and successive lines of a paragraph.  This causes the first line of a paragraph to be indented with one setting and the rest of the paragraph to have a different setting.  If this is set, the hanging indent value may be entered in the dialog.

Margins - Use paragraph left margin

This instructs UltraEdit to use the existing left margin of the paragraph that is being reformatted rather than specifying a new margin value.

Margins - Specify margin

This setting instructs UltraEdit to use the left margin value entered in the dialog as the indention for the left margin when reformatting the paragraph.

Margins - Right margin

This setting specifies the right margin to be used when reformatting the paragraph.  This is the last column number (starting at 1) at which text may be placed.

The margin settings above will be used for all reformatting commands including the Reformat Paragraph paragraph command.

All hard returns are removed for the paragraph, and the paragraph is reformatted based on the settings.

The complete file may be reformatted using the Select All command to first select the complete file, then reformat it.


Template Definition
Display/Modify Templates command (Advanced menu)

Use this command to display the dialog for editing the templates.  A template is a pre-defined text that may be recalled automatically at a later time and inserted into a file.

Up to 20 templates may be defined.  Each template may be recalled at a later time using hot keys Alt+0 through Alt+9, and Shift+Alt+0 through Shift+Alt+9, or with the Insert Template dialog.

Each template may optionally have a name associated with it, that if defined will show up on the tool tips (32-Bit only) on the toolbar, and in list of templates when inserting a template.

The templates are stored in a file in the default directory, or the directory specified in the General Options configuration page.

A template may contain special text strings that are translated at the time the template is recalled.  These special strings are:

[DATE_DMY]	Is translated into the current date with the format DAY/MONTH/YEAR.

[DATE_MDY]	Is translated into the current date with the format MONTH/DAY/YEAR.

[DATE_TEXT]	Is translated into the current date with the date diaplayed as text.

[TIME]	Is translated into the current time IN 24 HOUR FORMAT.

^	This indicates the position at which to place the cursor after the template has been inserted.

[FULL_FILE_NAME]	Is translated into the full path and filename of the active document.

[FILE_PATH]	Is translated into the drive and path of the active document.

[FILE_NAME]	Is translated into the root filename of the active document.

[FILE_EXTENSION]	Is translated into the file extension of the active document.

Note - ^ refers to the character '^' NOT Control Key + value.

Additionally, for extended date and time formatting, UltraEdit supports the following enhanced functionality:

Time

To specify the USER TIME format use the following syntax in your template:

For local time use the following markers:

[TIME_USER]...time format string here...[TIME_USER_END]

For system time use the following markers:

[TIME_USER_SYS]...time format string here...[TIME_USER_SYS_END]

The time format string is defined as follows:

If you use spaces to separate the elements in the format string, these spaces will appear in the same location in the template. The letters must be in uppercase or lowercase as shown (for example, "ss", not "SS"). Characters in the format string that areenclosed in single quotation marks will appear in the same location and unchanged in the template.

String  Meaning

h	Hours with no leading zero for single-digit hours; 12-hour clock

hh	Hours with leading zero for single-digit hours; 12-hour clock

H	Hours with no leading zero for single-digit hours; 24-hour clock

HH	Hours with leading zero for single-digit hours; 24-hour clock

m	Minutes with no leading zero for single-digit minutes

mm	Minutes with leading zero for single-digit minutes

s	Seconds with no leading zero for single-digit seconds

ss	Seconds with leading zero for single-digit seconds

t	One character time marker string, such as A or P

tt	Multicharacter time marker string, such as AM or PM

For example, to get the time string

"11:29:40 PM"

use the following format string:

"hh':'mm':'ss tt"

This string MUST be between the markers, for example:

[TIME_USER]hh':'mm':'ss tt[TIME_USER_END]

Date

To specify the USER TIME format use the following syntax in your template:

For local date use the following markers:

[DATE_USER]...date format string here...[DATE_USER_END]

For system date use the following markers:

[DATE_USER_SYS]...date format string here...[DATE_USER_SYS_END]

The date format string is defined as follows:

Use the following elements to construct a format string. If you use spaces to separate the elements in the format string, these spaces will appear in the same location in the template. The letters must be in uppercase or lowercase as shown in the table (for example, "MM" not "mm"). Characters in the format string that are enclosed in single quotation marks will appear in the same location and unchanged in the template.

String  Meaning

d	Day of month as digits with no leading zero for single-digit days.

dd	Day of month as digits with leading zero for single-digit days.

ddd	Day of week as a three-letter abbreviation.

dddd	Day of week as its full name.

M	Month as digits with no leading zero for single-digit months.

MM	Month as digits with leading zero for single-digit months.

MMM	Month as a three-letter abbreviation.

MMMM	Month as its full name.

y	Year as last two digits, but with no leading zero for years less than 10.

yy	Year as last two digits, but with leading zero for years less than 10.

yyyy	Year represented by full four digits.

For example, to get the date string

"Wed, Aug 31 94"

use the following picture string:

"ddd',' MMM dd yy"

This string MUST be between the markers, for example:

[DATE_USER]ddd',' MMM dd yy[DATE_USER_END]


Inserting Templates
Insert Templates command (Advanced menu)

Use this command to insert a template.  It presents a dialog, allowing you to select the template you wish to insert from the list of templates.

Optionally, the hot keys Alt+0 through Alt+9 and Shift+Alt+0 through Shift+Alt+9 may be used instead of this menu command.


Large Files
Large file handling

UltraEdit allows editing of very large files.  This is accomplished with relatively small amounts of memory being used.  UltraEdit is a disk based editor, and only loads a small portion of the file into memory at one time.

Normally, UltraEdit copies a file that is being edited to a temporary file, and at the end of the editing session deletes the file, after copying back to the appropriate original file.

To speed up editing of very large files, the  General Options configuration page allows you to specify editing without using temporary files.  This removes the time necessary to copy the file to a temporary file.  When editing files of many megabytes this can be an advantage.

WARNING - If this option is selected, all changes are permanent!

A dialog box is shown warning the user this setting is enabled each time a file is opened.  This may be disabled by changing the INI settings.

Additionally, the Disable Line Number option improves the performance when navigating around large files as less disk access are required to track the line numbers.


DOS Commands
DOS Command (Advanced menu)

This command allows a DOS command to be run from within UltraEdit and the results of the command are captured and automatically displayed with UltraEdit at the completion of the command.

A dialog box is presented that allows the command to be specified (with a browse button) and the working directory to be specified (working directory only supported with UltraEdit-32).

The command line specified should be the full path of the file to be executed unless it is a system command (such as DIR), or it is in the Windows directory, or the Windows System directory.

The working directory should be the full path of the working directory, or left blank if not required.

In order to allow maximum flexibility of programs to be run, a special command line sequence is permitted that will cause the active filename to be inserted into the command line and passed to the program to be executed.  For example:

You set up a command to run a compiler and you want to invoke the compiler with the file you are currently editing.  If you change files you want the compiler to be invoked with the new file.  The compiler is c:\comp\compiler.

Specify the following command in the dialog box:

c:\comp\compiler %F

When the command is executed, the %F will be replaced by the full directory path, filename and extension of the active window,  The file will be saved before the command is executed.

The following commands may be used to pass a portion of the full qualified filename:

%P	Path only ("C:\project\test\")

%N	fileName only ("test")

%E	Extension only (".c")

%P%N%E is equal to %F which is ("C:\project\test\test.c") in the example above.

NOTE - If the %f, %p, %n, %e are lower case the filenames are passed as long filenames and should be put in quotes, i.e. "%f" or "%p%n" etc.  If the %F, %P, %N, %E are in upper case the filename and path will converted and passed as the "8.3" short filename specification for maximum compatibility with DOS programs.

Additionally the following commands are available:

%R 	This may be used for the full path/name of the project (%r for long name, %R for short name)

%RP 	This may be used for the full project path (%rp for long name, %RP for short name)

%RN 	This may be used for the project name only (%rn for long name, %RN for short name)

%modify%	In some cases it may be necessary to modify the command line parameters each time the tool is run.  To do this, add %modify% in the command line and when the tool is run a dialog box will be shown allowing the user to modify the command line or cancel and run without modification.

%sel%	This instructs UltraEdit to add the highlighted/selected text from the active document into the command line in place of the %sel%.

The output from the command will be captured and displayed in a window when the command has completed.

As the output from a DOS program is sometimes buffered by the operating system, this process may not work correctly with a program that requires interaction while it is executing, the prompts may not appear on the screen at the correct time and the user may wonder why there is no activity.

As the output will always be captured.  If the program generates no console screen output the captured output may be empty and UltraEdit will show an empty window.

Note - If the capturing the output does not work correctly, or the command does not function correctly you may try the Alternate Capture Method command from the Advanced Menu (32-Bit version only).

The Last DOS Command repeats the last command specified with the DOS command dialog without presenting the dialog box.


Alternate Capture Method
Alternate Capture Method (Advanced menu)

This command changes the method used to capture the output from a DOS or Console application run from within UltraEdit.  Under Windows 95 some applications do not run correctly, or do not capture output correctly using the standard method.

The primary difference is that this alternate method does not show the output of the command on the DOS Window as it is executing.

This method does however resolve issues seen by some users.


Run Windows Program
Run Windows Program (Advanced menu)

This command allows a Windows program to be executed from within UltraEdit.  The output is not captured.

A dialog box is presented that allows the command to be specified (with a browse button) and the working directory to be specified (working directory only supported with UltraEdit-32).

The command line specified should be the full path of the file to be executed, unless it is in the Windows directory, or the Windows System directory.

The working directory should be the full path of the working directory, or left blank if not required.

In order to allow maximum flexibility of programs to be run, a special command line sequence is permitted that will cause the active filename to be inserted into the command line and passed to the program to be executed.  For example:

You set up a command to run a compiler and you want to invoke the compiler with the file you are currently editing.  If you change files you want the compiler to be invoked with the new file.  The compiler is c:\comp\compiler.

Specify the following command in the dialog box:

c:\comp\compiler %F

When the command is executed, the %F will be replaced by the filename of the active window,  The file will be saved before the command is executed.

The following commands may be used to pass a portion of the full qualified filename:

%P	Path only ("C:\project\test\")

%N	fileName only ("test")

%E	Extension only (".c")

%P%N%E is equal to %F which is ("C:\project\test\test.c") in the example above.

NOTE - If the %f, %p, %n, %e are lower case the filenames are passed as long filenames and should be put in quotes, i.e. "%f" or "%p%n" etc.  If the %F, %P, %N, %E are in upper case the filename and path will converted and passed as the "8.3" short filename specification for maximum compatibility with DOS programs.

Additionally the following commands are available:

%R 	This may be used for the full path/name of the project (%r for long name, %R for short name)

%RP 	This may be used for the full project path (%rp for long name, %RP for short name)

%RN 	This may be used for the project name only (%rn for long name, %RN for short name)

%modify%	In some cases it may be necessary to modify the command line parameters each time the tool is run.  To do this, add %modify% in the command line and when the tool is run a dialog box will be shown allowing the user to modify the command line or cancel and run without modification.

%sel%	This instructs UltraEdit to add the highlighted/selected text from the active document into the command line in place of the %sel%.

To run a DOS program use the DOS Command.


Insert Literal Character
Insert Literal Character (Keyboard Command)

This command allows a literal character (such as Control C) to be inserted into the file.  Pressing Ctrl+I tells UltraEdit that the next character is to be inserted directly into the file without any translation.

This is useful for inserting control codes that may be needed by printers or other devices.

Example:

Ctrl+I followed by Ctrl+C inserts a Control C character into the file

Ctrl+I followed by ESC inserts an escape character into the file

Shortcut

Keys:	Ctrl+I


Match Brace
Match Brace (Edit menu)

This command searches forward in the file from the cursor position to find an open or close brace.  If an open brace is found, the search continues in a forward direction until a matching close brace is found at the same nest level.  If the first brace found is a close brace, the search is performed in the reverse direction until a matching open brace is found at the same nest level.

When the matching brace is found, all the text between and including the two braces is highlighted.

An open brace is (, [, or {.  A close brace is ), ] and }.

Shortcut

Keys:	Ctrl+B


Read Only
Read Only Command (Edit menu)

The Read Only command toggles the state of the read only status of the file.  If the read only status is set the file can not be modified.  If the file has already been modified the modifications are maintained and the file may be saved.

The default behavior of the read only status may be configured in the General Configuration Page.  This determines if the file is read only when it is opened.


Select Line
Select Line (Edit menu)

The select line command highlights the line in which the cursor is positioned.  The end of line characters are also highlighted.  This allows an easy mechanism to select a line and Cut it to the clipboard.

Use the Select All command to select the complete file.

A line may also be selected by triple clicking the mouse.  This will cause the complete line to be selected including the hard return at the end of line.


Select All
Select All (Edit menu)

The select all command highlights the complete file. This allows an easy mechanism to select the complete file and Cut it to the clipboard.

Use the Select Line command to select a single line.

Shortcuts

Keys:	CTRL+A


Delete Line
Delete Line (Edit menu)

The delete line command deletes the line in which the cursor is positioned.  The end of line characters are also deleted.

Use the Select Line command to select the line.


Insert Date and Time
Insert Date/Time (Edit menu)

The insert date/time command inserts the date and time at the cursor position.  The date and time are formatted according to the control panel settings.  A single space is inserted between the date and time.

To insert only the date or time the a Template definition feature may be used.


Configure Toolbar
Configure Toolbar (Configuration)

The Toolbar may be configured to include up to 50 items of the users choice.  Any feature listed in the menus may be configured to the toolbar using the dialog presented.

The Feature List lists all the features that may be displayed on the toolbar including a Button Separator to separate groups of buttons.

The Toolbar List displays the currently selected list of features in the toolbar.

To add an item to the toolbar, select the position in the toolbar list at which the new item is to be inserted.  In the feature list, select the item to be inserted.  Click the insert button to insert the item in the toolbar.

To remove an item in the toolbar, select the item in the toolbar to be removed.  Click the remove button to remove the item from the toolbar.

The items in the feature list are listed in the same order as they appear on the menus.

The default button resets the toolbar list to the default configuration.

Use Large Icons On Tool Bar

If checked, large icons are used on the tool bar.  This option is only read at startup.


Registration Information
Registration

UltraEdit/UltraEdit-32 is a shareware program.

You are limited to 45 Days of use for an unregistered version.

If you find it useful and continue to use it you are obligated to register it with the author by sending $30.00 (Ohio Residents add $1.65 Sales Tax) to:

        Ian D. Mead

        8209 Chestnut Hill Ct.

        West Chester, OH 45069

        USA

Full and updated registration information is available at http://www.idmcomp.com or http://www.ultraedit.com including a secure online order form.

VISA/MASTERCARD/American Express Accepted

For VISA/MasterCard/American Express orders, include:

1) Name of card holder

2) Address of card holder

3) Name and address of user if different from card holder

4) Expiration date of card

5) Card #.

Credit card orders may be faxed  to (513) 779 8643 or telephoned to (513) 779 8549,

or sent to my E-Mail address (see below).

CompuServe Registration

UltraEdit may also be registered online on CompuServe by typing GO SWREG and following instructions for registering using ID 2662 for UltraEdit and ID 4017 for UltraEdit-32.

This will entitle you to an authorization code, the latest registered version, and technical support.

For CompuServe registrations, a newer version is not sent out if the latest version is available on CompuServe.

E-Mail Address

Internet:       	IDM@idmcomp.com (backup e-mail is idm@ultraedit.com or idm@iglou.com)

CompuServe:	71613,2654

WWW Page:	http://www.idmcomp.com or http://www.ultraedit.com

Registrations for UltraEdit and UltraEdit-32 receive authorization codes that work with both products.  No upgrade fee is required to switch from UltraEdit to UltraEdit-32.  UltraEdit and UltraEdit-32 are packaged individually for convenience of file size downloading.

Upgrades

Users are entitled to free upgrades for at least 1 year, often longer (of all feature and maintenance releases).  If for some reason your authorization code does not work with the latest release and you registered within 1 year you will be issued a new authorization code free of charge.

The upgrade fee for previously registered users is $15.00 (Ohio residents should add $0.83 Sales Tax).


Latest Version Information
Latest Version

The latest version of UltraEdit/UltraEdit-32 may be found in several places:

The following www page:

http://www.idmcomp.com and http://www.ultraedit.com

In the WINUSER Forum on CompuServe, an official distribution and support online resource for future updates.  Search for ULTRAEDIT.ZIP, and UEDIT32.ZIP.

The Windows Users Group Network (WUGNET), operators of the oldest and largest independent support resource forum (WINUSER) for Windows Users on CIS with nearly 1,000,000 active members is recognized in the press, user groups, developers, and Microsoft as the foremost resource for shareware publishers on CompuServe and the Internet.

On the Internet on several sites, including CICA and other sites.


Double Clicking
Double Click Selections

UltraEdit allows for selection of text by double clicking the primary mouse button (usually the left button).  Normally a single word is selected made up of any alphanumeric character or underscore _.

If at the time the primary mouse button is double clicked the control key is pressed, a string is selected rather than just a single word.  This can be very useful in selecting filenames, e-mail addresses etc.  The characters that delimit the string are configurable in the General Options configuration page.  This function works on a single line only.

These entries, one for the left edge of the text to be selected and one for the right edge specify what characters should be used to stop any further text from being selected.  If a space only is specified in each field all text either side of  the cursor position will be selected until a space is encountered.

If text is selected when the right mouse button is pressed, a new menu item Open File Highlighted is added to the top of the pop-up menu and if selected the file is opened if it exists.


Reloading Files at Startup
Reload Open Files on Startup

If this option is checked, UltraEdit saves away information about the open files when UltraEdit is closed.  This information is used to automatically reload the files that were open the next time UltraEdit is started.  This allows easy reloading of a setof files that are edited on a regular basis.  If UltraEdit is invoked automatically for printing, the files are not reopened.


Sort File
Sort File (File menu)

This command sorts each line of the active file according to the current sort options.  Any size file may be sorted.  See the Advanced Sort/Options for details.

If a portion of the file is selected, only the selected portion is sorted.  The rest of the file will not be modified.


Sort File
Advanced Sort and Options (File menu)

This command allows you to set the sort options and perform a sort of the active file.  The sort is performed on the complete file.  The UNDO command is not supported with sort operations.

When this option is selected, a dialog is presented with the following options:

Sort Order

Ascending	- This sets the sort for ascending order (a to z, 1-9) and is the default.

Descending	- This sets the sort for descending order (z to a, 9-1).

Remove Duplicates

If this is checked, any lines that are found to be identical to another are removed, the first line is preserved.  If the Ignore Case  option is set, lines are considered identical if the characters are the same with the only difference being the case ofthem.

Ignore Case

This option should be checked if you want the search to be insensitive to case, i.e. CAT is considered the same as cat.  Do not check this option if the sort should consider CAT different from cat.

Starting Column

You may specify the column at which the sort is to be based.  The options are:

Column of Cursor or

Specific Column Number

If you select the column of cursor, the sort will be based on the characters at the column number the cursor is positioned to at the time the sort is invoked.  Alternatively, you may specify the column number (1 being the first column) at which the sort is based.  The default behavior is column 1 specified.

These options are saved between UltraEdit sessions and are used by the Sort File command.


User Tools
Tools Configuration/Use (Advanced menu)

UltraEdit allows the user to configure up to ten menu items to commands of the users choice.  These commands may be any DOS or Windows commands, and when set up appear in the lower portion of the Advanced menu.

When the Tool Configuration menu item is selected, a dialog box is presented allowing the user to specify the command line and action for each of the users choices.  The following information is presented:

Command Line:

This is the actual command line that will be invoked it may contain a '%F' that will be replaced by the full directory specification and filename of the active file.  The file will be saved first if changes have been made.

You set up a command to run a compiler and you want to invoke the compiler with the file you are currently editing.  If you change files you want the compiler to be invoked with the new file.  The compiler is c:\comp\compiler.

Specify the following command in the dialog box:

c:\comp\compiler %F

When the command is executed, the %F will be replaced by the full directory path, filename and extension of the active window,  The file will be saved before the command is executed.

The following commands may be used to pass a portion of the full qualified filename:

%P	Path only ("C:\project\test\")

%N	fileName only ("test")

%E	Extension only (".c")

%P%N%E is equal to %F which is ("C:\project\test\test.c") in the example above.

NOTE - If the %f, %p, %n, %e are lower case the filenames are passed as long filenames and should be put in quotes, i.e. "%f" or "%p%n" etc.  If the %F, %P, %N, %E are in upper case the filename and path will converted and passed as the "8.3" short filename specification for maximum compatibility with DOS programs.

Additionally the following commands are available:

%R 	This may be used for the full path/name of the project (%r for long name, %R for short name)

%RP 	This may be used for the full project path (%rp for long name, %RP for short name)

%RN 	This may be used for the project name only (%rn for long name, %RN for short name)

%modify%	In some cases it may be necessary to modify the command line parameters each time the tool is run.  To do this, add %modify% in the command line and when the tool is run a dialog box will be shown allowing the user to modify the command line or cancel and run without modification.

%sel%	This instructs UltraEdit to add the highlighted/selected text from the active document into the command line in place of the %sel%.

Working Directory

This is the working directory for the specified command.  If applicable, the process will be started with this as it's working directory.  As above, the %P may be used to specify the path.  Note, the working directory may be specified for UltraEdit-32 but not for UltraEdit (16-Bit).

Menu Item Name

This is the name of the item as it appears on the Advanced menu.

Windows Program Checkbox

This must be checked if the program being invoked in the command line is a Windows application.

Command Output (DOS Commands ONLY)

DOS command output may be optionally captured to a file.  The four options for DOS command output are 1) append to existing file (create new file if one does not exist); 2) Replace existing file; 3) Create new file each time the command is run; and 4) Capture the output to a list box (Output Window). This list box allows the user to double click on a line of the captured output and UltraEdit attempts to open the referenced file and position to the specified line if found.

As several commands may be configured, it is quite possible the user may wish for some commands to always create a new file, while other commands should replace the existing file (or append to it).  For this reason, each capture mode (append, replace, new) will create a new file for that mode if one does not exist, and each time a command is run, the file for the given capture mode will be append to or replaced if appropriate, or a new file created if selected.

Command List Box

The command list box shows the configured commands.  By double clicking on a command in this list, the configuration items are pre-loaded with the parameters of this command and may be modified.  To keep the changes, the user MUST select REPLACE to overwrite the existing command, or INSERT to generate a new command.

If you click on an item, you may delete it by selecting the DELETE button.

Requirements

DOS commands require that certain files exist depending on the operating system:

Windows 95 requires the COMMAND.COM file be on the Windows directory.

Windows NT requires that CMD.EXE be in the path.

Windows 3.x requires that the DOSPRMPT.PIF be in the Windows directory.

Note - If the capturing the output does not work correctly, or the command does not function correctly you may try the Alternate Capture Method command from the Advanced Menu (32-Bit version only).


Set colors
Set Colors (View menu)

This menu item allows the user to configure the color of the following items:

Regular text

Background

Bookmark highlighting

Selected text color

Selected text background

Line/Column display text

Line/Column display background

Active line color

Active line background

Column markers

By clicking on the color a new color may be selected from the color dialog box.  For the background colors and bookmark color selections only solid colors are valid.

The background and bookmark colors are used for all files.  The text color is used for all files that are not recognized by the Syntax Highlighting.


Show Spaces, Tabs, New Lines
Show Spaces/Tabs (View menu)

This menu items allows the displaying of spaces, tabs and new line characters as visible characters on the screen.  It does not change the document, but allows you to clearly distinguish between the different characters.

Spaces are shown as:	'·'

Tabs are shown as:	'»'

New lines are shown as:	'¶'

If there is not enough room to show the '»' with the tab, the tab will appear as normal, and non visible.


Set Column Markers
Set Column Markers (View menu)

This menu items presents a dialog box allowing the user to specify the column numbers at which markers are displayed.

Two markers may be configured and displayed.  A column marker is a thin vertical line that indicates the position of the column on the screen.  If a column marker is specified to be at column 80, the marker is placed between the 80th column and the 81st column.

The column markers may be enabled/disabled independently using the menu items Show Column Markers.


Show Column Markers
Show Column Marker 1/2 (View menu)

These menu items toggle on and off the display of the column markers that may have been configured with the Set Column Markers menu item.


User Help Files
Add Help Files (Help menu)

This menu item allows Windows help files to be added to the UltraEdit Help menu for direct reference from within the editor.

Up to 5 help files may be added and will appear directly above this item in the help menu.  When this item is selected, a dialog box appears that allows the user to enter the help filename and path, or browse for a help file.  Additionally, a field exists for the name of the help file that will be used to identify it in the help menu.

If some text is selected within an open document within the editor, the user may press F1 to see a list of user configured help files that may be searched for the selected string.  Alternatively, with text selected in an open document, the user may select the appropriate help file from the help menu and that help file will be searched for the corresponding topic that matches the selection.

The topic will be shown if found in the help file.  If not, the search dialog with closest match of topics will be shown.

The user help files may be Windows Help files (.HLP) or compiled HTML files (.CHM) files.


Compare Files
Compare Files (File menu)

This menu item allows two ASCII files to be compared.  The files are compared, and if identical no further action is taken.  If the files are different, the files are shown in a separate window with the differences highlighted.

The file comparison performs a line-by-line comparison.  Binary files comparison results are undetermined.

When the compare files menu item is selected, a dialog box is displayed that allows you to select the files to be compared.

The file compare dialog allows the user to select the following options:

Differences in color

This option will show the differences in two different colors, one for lines added and another for lines that have been removed.  Additionally, lines will be indicated with a !> if they are new in the second file and<! if they have been removed in the second file.

Differences Side-by-Side

This determines if the file differences are shown side-by-side.  In this case, the scroll bar will need to be used to see both files.  The side-by-side view is a combination of the normal differences view, and two files being shown vertically side by side with the differences appearing on different lines.  The files differences are synchronized so that portions of the file that are the same show up beside each other.

It is recommended this setting be used only if the files have relatively few columns for better display.

Ignore Blanks

This option is used to allow the file comparison to ignore differences that are only white space characters (spaces, tabs).  If this option is selected, lines are considered identical if the only difference is white space.

Only Show Lines That Differ

With this option set the window showing the file differences will only show the lines that are different between the two files.  Lines that are identical will not show in the window.

When compare is selected in the dialog, the two files to be compared are opened in the editor and shown vertically beside each other.  All other files are minimized.

When the file differences are shown in the compare window, double clicking on the compare window will cause the files being compared to be positioned at the appropriate line within the editor for easy editing.

Any changes to the files will need to be saved and a new compare performed to update the compare window for correct line number positioning.

The compare function can handle very large files, however it may not be able to handle files as large as those that may be edited within UltraEdit due to its memory requirements for the compare operation.

With the 16-Bit version of UltraEdit, the compare features requires Win32s to be installed.  This function will not work on Windows 3.x without Win32s.

File Output

The output of the file contains the following designations:

<! 	Indicates the line is in the first file but not in the second (RED Color)

!> 	Indicates the line is in the second file but not in the first (Yellow Color)

(xxx) 	Where xxx is the line number indicates the line/text moved in the file relative to other lines.

There is a small invisible drag bar between the two side-by-side views that will show when the mouse is moved over the line.


Spell Checker Options
Spell Checker Options (Advanced Menu, configuration)

The spelling checker options configuration page allows selection of the main spelling dictionaries to be used by UltraEdit.  The user may select any of the languages shown, or if preferred may select to none of the languages in which case UltraEdit will use only the user dictionary.

The spelling checker will be slower for more languages selected.

UltraEdit is not distributed with all dictionaries as the size of these is prohibitive.  Ensure you have installed the appropriate dictionary before selecting a language.  Normally, the English (American) dictionary is distributed with UltraEdit.

Access from this page is given to select the User Dictionaries and additional Spell Checker Options.

Note: The spelling checker performance varies with the options selected.  If the Case Sensitive setting is selected the performance can be significantly improved.


License Agreement - Unregistered

LIMITED WARRANTY

THE PROGRAM IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.  IN NO EVENT WILL THE AUTHOR or AUTHORS BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING INCIDENTAL OR CONSEQUENTIAL DAMAGES, ARISING OUT OF THE USE OF THE PROGRAM, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

YOU ACKNOWLEDGE THAT YOU HAVE READ THIS LICENSE, UNDERSTAND IT AND AGREE TO BE BOUND BY ITS TERMS AS THE COMPLETE AND EXCLUSIVE STATEMENT OF THE AGREEMENT BETWEEN US, SUPERSEDING ANY PROPOSAL OR PRIOR AGREEMENT, ORAL OR WRITTEN, AND ANY OTHER COMMUNICATIONS BETWEEN US RELATING TO THE SUBJECT MATTER OF THIS LICENSE.

UltraEdit/UltraEdit-32 is a shareware program and is provided at no charge to the user for evaluation.  The purpose of shareware software is to provide personal computer users with quality software on a "try before you buy" basis, however payment is still required for continued use of the product.

If you find this program useful and continue to use it after a the trial period, you must make a registration payment (see the registration instructions for details).  This registration fee will license one user to use one copy of UltraEdit and/or Ultraedit-32 on any one computer at any one time.  All users will receive a copy of the latest release when they register, or it will be made available for downloading, and free technical support.

Commercial users must register and pay for their copies within 45 days of first use or their license is withdrawn.  Site License and multiple user license arrangements may be made by contacting IDM Computer Solutions, Inc.

Anyone distributing this product for any kind of remuneration must first contact IDM Computer Solutions, Inc. for authorization.

You may distribute this software to friends and colleagues but you must include all files in the original distribution.  Please encourage them to register their copy if they find that they make use of it.


License Agreement - Registered

This is a legal agreement between you (either an individual or an entity) and IDM Computer Solutions, Inc.  By opening the sealed software packages (if appropriate) and/or by using the SOFTWARE, you agree to be bound by the terms of this Agreement.  If you do not agree to the terms of this Agreement, promptly return the disk package and accompanying items for a full refund.

SOFTWARE LICENSE

1.	GRANT OF LICENSE.  This License Agreement (License) permits you to use one copy of the software product identified above, which may include user documentation provided in on-line or electronic form (SOFTWARE).  The SOFTWARE is licensed as a single product, to an individual user, or group of users for Muliple User Licenses and Site Licenses.  This Agreement requires that each user of the SOFTWARE be Licensed, either individually, or as part of a group.  A Multi-User License provides for a specified number of users to use this SOFTWARE at any time.  This does not provide for concurrent user Licensing.  Each user of this SOFTWARE must be covered either individually, or as part of a group Multi-User License.  The SOFTWARE is in use on a computer when it is loaded into the temporary memory (i.e. RAM) or installed into the permanent memory (e.g. hard disk) of that computer.  This software may be installed on anetwork provided that appropriate restrictions are in place limiting the use to registered users only.

2.	COPYRIGHT.  The SOFTWARE is owned by IDM Computer Solutions, Inc. and is protected by United States Of America copyright laws and international treaty provisions.  You may not copy the printed materials accompanying the SOFTWARE (if any), nor print copies of any user documentation provided in on-line or electronic form.  You must not redistribute the registration codes provided, either on paper, electronically, or as stored in the files ULTRAEDT.REG, UEDIT32.REG, ULTRAEDT.INI, ULEDIT32.INI or any other form.

3.	OTHER RESTRICTIONS.  The registration notification provided, showing your authorization code and this License is your proof of license to exercise the rights granted herein and must be retained by you.  You may not rent or lease the SOFTWARE, but you may transfer your rights under this License on a permanent basis, provided you transfer this License, the SOFTWARE and all accompanying printed materials, retain no copies, and the recipient agrees to the terms of this License.  You may not reverse engineer, decompile, or disassemble the SOFTWARE, except to the extent the foregoing restriction is expressly prohibited by applicable law.

LIMITED WARRANTY

LIMITED WARRANTY.  IDM Computer Solutions, Inc. warrants that the SOFTWARE will perform substantially in accordance with the accompanying printed material (if any) and on-line documentation for a period of 365 days from the date of receipt.

CUSTOMER REMEDIES.  IDM Computer Solutions, Inc. entire liability and your exclusive remedy shall be, at IDM computer Solutions, Inc. option, either (a) return of the price paid or (b) repair or replacement of the SOFTWARE that does not meet this Limited Warranty andthat is returned to IDM Computer Solutions, Inc. with a copy of your receipt.  This Limited Warranty is void if failure of the SOFTWARE has resulted from accident, abuse, or misapplication.  Any replacement SOFTWARE will be warranted for the remainder ofthe original warranty period or thirty (30) days, whichever is longer.

NO OTHER WARRANTIES.  To the maximum extent permitted by applicable law, IDM Computer Solutions, Inc. disclaims all other warranties, either express or implied, including but not limited to implied warranties of merchantability and fitness for a particular purpose, with respect to the SOFTWARE and any accompanying written materials.

NO LIABILITY FOR CONSEQUENTIAL DAMAGES. To the maximum extent permitted by applicable law, in no event shall IDM Computer Solutions, Inc. be liable for any damages whatsoever (including, without limitation, damages for loss of business profits, business interruption, loss of business information, or other pecuniary loss) arising out of the use or inability touse the SOFTWARE, even if IDM Computer Solutions, Inc. has been advised of the possibility of such damages.


Drag and Drop Editing

UltraEdit supports dragging and drop editing using  the mouse.

Drag and drop editing allows the user to select text in the normal manner and then copy or move the selected text by dragging it to a new location with the mouse.  No keyboard interaction is required.

Initially the user selects text in the normal manner.  Once text has been selected, the user may click the primary mouse button (usually the left button) on the selected text, at which time the mouse pointer changes to a pointer with a small dotted rectangular box at the bottom of the pointer.  This pointer indicates you are in the drag and drop editing mode and may drag the selection to a new location.

While keeping the primary mouse button down the selected text may be dragged to a new location.  As you move the mouse the cursor will follow the mouse and the cursor indicates the new position of the text if you stop pressing the mouse button (and "drop" the text).

The user may even drag the text from one file to another within UltraEdit.  If the mouse is positioned over a different file within UltraEdit, that file will become active and the text may be dropped into that file at the cursor position shown.

At any time, pressing ESCAPE will cancel the drag and drop mode.

Additionally, instead of moving the text being dragged it may be copied to a new location.  If at any time while in the drag and drop mode the CTRL key is pressed and held the mouse pointer changes to have a small '+' symbol beside it indicating the textwill be copied to the new location indicated by the cursor and also remain in the original position.

Drag and Drop editing is supported in normal, HEX and Column editing modes.


Default Save Directory
Default Save Directory (Directories Configuration Page)

Normally the directory used for the Save As command is the default directory which may vary depending on which directory was last used for a file open and may be any directory.

This may be overridden by specifying the default directory that is always presented when the Save As command is used.  This item is specified in the Advanced General Configuration page.

If this item is left blank then the default directory is the default directory for the process.


Default Backup Directory
Default Backup Directory (Backup Configuration Page)

Normally the directory used for the backup file is the same directory as the source file.  This parameter allows all  backup files to be copied to the same backup directory.

If this item is left blank then the directory used will be that of the source file.


Default Open Directory
Use Default Directory/Use Active File Directory For File Open (General Configuration Page)

Normally the directory used for the File Open command is the last directory that UltraEdit opened a file from.  This directory information is retained when UltraEdit is shutdown and restarted.

When the Use Default Directory for File Open option is set, the normal behavior is overridden and the process default directory is used.  This allows the user to specify the default directory from the icon or shortcut that invokes UltraEdit.  In this case, the directory information is not retained by UltraEdit and it always uses the default directory for the process.

When the Use Active File Directory for File Open option is set, the normal behavior is overridden and the directory of the currently active file is used.  This allows the user to easily open a file from the same directory as an already open file by activating the file and then use the File Open command.

Only one of these should be selected.


File Insert String At Increment
Insert String At Every Increment (File - Special Menu)

When handling large database type files it is sometimes necessary to split the file into "records" or known line lengths as the file has been output without any delimiters/separators between records.

This feature allows a user specified string to be inserted at a constant user specified increment in the file from some start point in the file to some end point in the file.

Start Point:

The start point for this operation may be the beginning of the file, or the position of the cursor.  This is helpful if the file has a header in it that should not be treated as part of the data.  The default behavior is that the beginning of the file isthe start point.

End Point:

The end point may be specified as one of the following:

- The end of the file (default behavior)

- A known offset into the file

- After the specified number of records have converted

-When a particular string is found, in this case the insertion stops at or before the beginning of the string if found, if not found the option to continue or not is given.

Example:

A data base file has records of known length of 2000 characters.  Each record has been output consecutively with no separation between the records.

For editing purposes, you want to put each record onto a single line.

With this feature, you can specify the string to insert is "^p" (insert a newline - paragraph) and that the increment at which to insert the string is every 2000 characters.

UltraEdit will add the new line at the end of each record until the end of file is encountered.


EBCDIC to ASCII conversion
EBCDIC to ASCII file conversion (File - Conversions Menu)

This functions converts the complete file from EBCDIC format to ASCII.  This is useful in dealing with files that are in the EBCDIC file format (usually on Mainframe computer systems).


ASCII to EBCDIC conversion
ASCII to EBCDIC file conversion (File - Conversions Menu)

This functions converts the complete file from ASCII to EBCDIC format.  This is useful in dealing with files that need to be exported in the EBCDIC file format (usually on Mainframe computer systems).


INI File Selection/Advanced Settings
INI File Selection and Advanced Settings

UltraEdit maintains most of its configuration settings in an INI file (see below to override this).  This allows the user to select the INI file to be used under different configurations and allows the user to maintain the settings for UltraEdit when using UltraEdit from different workstations on a Network.

The default INI files used by UltraEdit are ULTRAEDT.INI for UltraEdit and UEDIT32.INI for UltraEdit-32.

Telling UltraEdit which INI file to use

To override the default behavior, you may use a command line parameter, an environment variable, or add an INI file to the directory containing UltraEdit.

The rules are as follows:

The command line is checked first; if the command line contains "/I=filename" this is uesd.

Example: /i=c:\windows\uedit32.ini

The filename must follow the /i= immediately.  It can be a long name with spaces, in which case it must be in quotes.

If the command line parameter is not found the environment variable is checked.  Please note, the environment variable specifies the directory that will contain the INI file, NOT the INI filename itself.  The environment variable name is UEINIDIR.  If this is defined, UltraEdit attempts to use this directory with the default INI filenames.

Finally, UltraEdit will look in the directory the EXE file is running from to locate the INI file and if it is not found, the Windows directory will be used.

Advanced INI Settings

Additional INI settings have been made available and are currently provided without user interface support -i.e. You can not use a dialog box or menu function in UltraEdit to change them.  These have been provided to support users requests.

These should always be added under the heading [Settings].

Auto Reformat = 1

This setting causes the editor to automatically reformat a paragraph after a paste command if the Word-Wrap settings are set to wrap at a specific column number with the insertion of hard returns (CR/LF).  UltraEdit defaults to this behavior and setting this value to 0 will disable this feature.

Caret Char = "some character"

This setting allows a different character to be used in Find/Replace routines from the caret (^).  The character should be in quotes.  It is recommended a pipe character (|) or similar uncommon character be used.

Caret Type= 0,1,2

This setting determines the type of caret.  If set to 0 (default) in Insert Mode the caret will be a vertical bar and in Overstrike Mode the caret will be a block caret.  If set to 1 the block caret is disabled.  If set to 2 the caret type will be reversed such that in Insert Mode the caret will be a block caret and in Overstrike Mode the caret will be a vertical bar.

Column Overstrike=1

With this setting set to one (1), the column operations operate either in insert mode (as default) or overstrike/overpaste mode based on the insert/overstrike keyboard setting.  This is toggled by the Insert Key and shows up on the status bar.

If in the overstrike mode, cut/delete operations will remove the contents but leave spaces so that column data is not shifted.  Paste operations will paste over the current position data and not shift columns either.

If its is preferred that the overstrike mode is what you require permanently for column mode, you may set the INI value to two (2).

ConvertKBDInput  = 1

This setting instructs UltraEdit to convert the keyboard input from ANSI to OEM if an OEM font is selected.  The default setting is not to perform any conversion.

Default File Type = 0, 1 or 2

This setting determines the default file type for NEW files created within UltraEdit.  The default (0) is for DOS files.  Set this to 1 for UNIX files, or 2 for MAC files.

DisableFlatToolBar=1

This setting disables the "Flat" style toolbar for Windows 95 and Windows NT 4.0 and later.  If this setting is used, the toolbar will be shown with the raised buttons and separators between buttons.

DontUseRename=1

This setting affects how UltraEdit generates the backup file.  The reason for the setting is that on some systems, if UltraEdit renames the original file to the backup the original file when it is recreated does not maintain the file permissions that previously existed.

This setting instructs UltraEdit to copy the original file to the backup and not to rename it.  This is slower than renaming it but does preserve the file permissions.

Large File Buffers= 1

This setting determines if UltraEdit should use larger buffers internally for some of it's operations.  This can speed up some operations on very large files but is very much hardware dependant.

Lock File = 1

This setting causes the editor to keep the lock on any file that is opened.  Additionally, if the file is already locked, it allows for open by read-only in this case prompting the user with a dialog box to confirm the open as read-only.  This feature prevents modification of a file from outside of the edit session preventing loss of changes made.

Make Changed Files Active = 1

This setting sets instructs UltraEdit to make any file it detects as changed and reloads to be the active file.  The default setting (0) is not to make the file active.

Max Columns  =

This setting sets the maximum columns allowed within UltraEdit before it wraps the line (soft wrap).  The default is 4096 columns but a maximum of 9216 is allowed.  Some video drivers have a problem when this is set too high.

New File = 0

This setting instructs UltraEdit not to create a new empty document file when it starts up without other files to open.  The default setting is to create a new document file if no files are being opened automatically when UltraEdit starts up.

No Temp Confirm=0

This disables the dialog box asking for confirmation when opening a file without a temporary file.

Open Link Files = 1

This setting causes the editor to open the link for modification.  The default setting of FALSE causes UltraEdit to expand the link to open the root file.

Open Maximized = 1

This setting determines if UltraEdit should always open it's main window in a maximized state.  The default is for UltraEdit to remember the previous settings.  If this setting is set to 1, UltraEdit will open the main window in a maximized state.

Reload FTP Files = 1

This setting determines if UltraEdit should reload FTP files when it reloads files for a project/workspace.  Typically UltraEdit does not reload FTP files automatically due to the potential time delay in connecting and load the files.  Setting this to 1 will ensure UltraEdit treats FTP files as normal files in this regard.

Show Tag Descriptions = 1

This setting determines if UltraEdit should show the descriptions for the tags in the Tag List.  By default the tags are shown.  If this value is set to 0, the tags will not be shown.

Sort Function List = 0

This setting determines if UltraEdit should sort the Function List output when it is shown.  By default the Function List is sorted.  If this value is set to 0, the Function List will not be sorted.

Temp File Dir

This setting allows the user to specify the directory UltraEdit uses for the temporary files it creates while editing.  Normally this should not be set but can be used if editing large files and there is not sufficient room in the temp directory for the temporary files UltraEdit creates.

The format is:

Temp File Dir= "directory"

TitleNameOnly = 0

This setting allows the user to specify that UltraEdit should only display the filename only and not the path in the title bar for the editing window.  When set to 0 the filename and path will be displayed (default).  When set to 1, only the filename will be displayed.

Use DDE Associations = 0

When File Associations are set from within UltraEdit the setting to use DDE  is normally set in the registry for the specific file type.  On some systems this may cause an error message when the file is double clicked from Explorer.  In this case setting Use DDE Associations = 0 may resolve this.  The file associations will need to be modified for this to take effect.

Use Registry = 1

This setting causes the editor to save and retrieve all settings from the Registry.  After UltraEdit determines the INI file in use it checks for this value before reading any other values.  If this is set, UltraEdit stores all settings in the Registry.


File Associations
File Associations (Advanced Menu - Configuration)

The File Associations dialog allows the user to associate UltraEdit with selected file types.  This dialog shows a list of current associations for UltraEdit, and a list of file types that UltraEdit determines the user may wish to associate with UltraEdit.

The user may add or remove file associations using this dialog.

This feature is available in the 32-Bit version only.

A file association is used by Windows Explorer to determine which application is to be used to open the file when the file is double clicked or opened in the Explorer.

The list showing UltraEdit Associations shows all file types that are currently associated with UltraEdit.  The user may select any item in this list and remove the association with the Delete Button.

To add an association, the user may select an item from the FileTypes/Extensions drop down list or type in a new extension and add it with the Add button.  The Description may be modified for any file type that is added.

When an association is added, UltraEdit saves the old association if it exists and restores it if the UltraEdit association is later removed using this dialog.


Word Count
Word Count (Search Menu)

The word count feature analyzes the document and determines the number of Words, Lines and Non-Space characters in the file and displays the result.

The number of lines determined are real lines terminated with the line terminator.  If a line is wrapped in the display, this is not counted as multiple lines.


Configure Keyboard Mapping
Configure Keyboard (Advanced Menu - Configuration)

The Configure Keyboard dialog allows the user to reassign the default key mapping provided my UltraEdit to suit their particular needs.

This feature is available in the 32-Bit version only.

This dialog shows a list of commands within UltraEdit that may be mapped by the user to a key combination of their choice.  Clicking on any of the commands will show the existing key assignment (if any) and the command description below the list.

To add or change a command key assignment:

1) 	Select the command you wish to modify from the Commands list.

2) 	Clicking the mouse in the Press New Key entry window area, or TAB to give it focus.

3) 	Type the new key assignment just as you would if you were invoking the command - This key combination will be captured and displayed.

4) 	Click on the Assign button and the new key will be assigned to the command.  If an existing key is assigned you will be asked if you wish to delete it and replace with the new assignment.

To remove a key assignment:

1) 	Select the command you wish to modify from the Commands list.

2) 	Select the existing key assignment from the Existing keys list.

3) 	Click on the Remove button and the key assignment will be removed.

To reset the key assignments to the default:

1) 	Click on the Defaults button and the key assignments will be reset to the defaults.  The uses will be prompted to confirm the action.

File Containing User Keyboard Mapping

The keyboard mapping file is stored (and searched for when UltraEdit starts up) in the same directory as the INI File. The filename is the same as the exe with the .KBD extension, i.e. UEDIT32.KBD.


DDE Support

UltraEdit supports the following DDE commands.  They are all part of the "System" topic.

Command:	Function:

[open("filename")]	Opens the specified file.  Following the filename any of the normal command line parameters may be specified for macro running, positioning at line number etc.

[save()]	Saves the active document.

[print("filename")]	Print the specified file.

[printto("filename","printername","printer driver","port")]	Print the specified file to the specified printer, giving the printer name, printer driver and port.

These commands must be passed exactly as shown.

The following example uses DDE open to open a file and run a macro:

[open("filename" /M,E,1="full path of macro file/macro name")]


Open Document Tab Selection
Toggle Open File Tabs (View Menu)

This menu item enables or disables the TAB control that allows the user to select between open documents.  The tab control allows easy selection between open documents while maintaining all other window switching and display functionality.

If you right click on the open file taps a pop-up menu is displayed with several file options.

The TAB control may be dragged from it's default docked position at the top of the main window and docked at the bottom of the window, or left standalone.  If it is standalone, it may be resized vertically and horizontally as desired.

When the TAB control is in it's default docked position, scroll arrows appear if more documents are open than can be displayed.

The TAB control may be resized.  If resized while docked so that more than one row of tabs are shown the scroll arrows will no longer be available.

Right clicking on an open file tab will allow the file tabs to be sorted.  These will be sorted alphabetically when the command is performed.  Due to the operation of the underlying control used, if multiple lines are displayed the underlying control will reorder the ROWS of tabs but internally keep the order the same,  This means that the sort will work but the rows may not be in order and will change order if a file from a different row is selected.

This feature is supported in the 32-Bit version ONLY.


Fixed Columns
No Scroll Left Side of Marker 1 (View Menu)

UltraEdit provides for Column Markers that display a vertical line at a specified column.

This menu item works in conjunction with the column markers.  When this item is checked (enabled) the columns to the left of the 1st column marker are fixed, and do not scroll horizontally while the columns to the right of the column marker will scroll as normal when the horizontal scroll bar is used, or when the cursor is positioned to the right hand side of the window forcing a horizontal scroll.

If this feature is enabled, columns to the right of the marker will scroll horizontally while columns to the left will not.  While the horizontal scroll is in effect, any mouse selection or clicking of the primary mouse button within the fixed portion ofthe display will cause the horizontal scroll position to be reset allowing viewing and editing of the continuous columns.

If the 1st column marker is disabled, or set to 0 this function will have no effect.


Display Ruler
Display Ruler (View Menu)

This menu item toggles the column ruler that displays the column numbers at the top of each window.

The ruler indicates the column number in even increments.  For fixed pitch fonts this will show the correct column indication.  For variable pitch fonts, this will show the column numbers based on the average character width for the active font.

The ruler colors may be set with the Set Color dialog.


Display Line Numbers
Display Line Numbers (View Menu)

This menu item toggles the line number display on the left hand side of the window.

The line numbers are shown in a fixed area on the left hand side of the Window for each file if this item is checked.  The font used is automatically selected based on the current font and is slightly smaller than the selected font for display.

The color of the line numbers may be set with the Set Color dialog.

To print a file with line numbers, make the appropriate selection under the Page Setup dialog (File Menu).


Display file in Browser
Show File in Browser (Window Menu)

This feature allows the active file to be displayed in the default WWW browser.  For this feature to work, the user must have installed a WWW browser and the file types/extensions must be registered in Explorer/File Manager.  The file types/extensions used are ".HTML" for the 32-Bit version and ".HTM" for the 16-Bit version.

When selected, UltraEdit creates a temporary copy of the file and invokes the default browser with this file.  The temporary file is deleted when the original file is closed, or if the user invokes the browser again with the same file.


ASCII Table Display
ASCII Table (View Menu)

This feature displays a pop-up dialog which contains an ASCII Table.

This table contains the following columns:

Character

This column shows the characters as they would be displayed using the selected font.  The font may be changed using the "Select Font" button.

Decimal #

This is the decimal value of the character in the range of 0 to 255.

Hexadecimal #

This is the hexadecimal value of the character in the range of 0 to FF.

Name #

This is the recognized name for the character.  This is for the first 32 characters only.

Ctrl Character #

This is the recognized control character that the character represents.  This is for the first 32 characters only.

To view the characters with a different font use the "Select Font" button.  When the ASCII Table starts up it defaults to the font currently selected within the editor.

If you wish to insert any of the characters in to the active file select the character and click the "Insert Char" button or double click the character in the table.


Favorite Files Dialog
Favorite Files (File Menu)

The Favorite Files feature allows a user to store the filenames of frequently opened files, or favorite files that the user wishes to quickly reference and open in the future.

When the Favorite Files menu item is selected, a dialog is displayed that allows the user to open one or more of the favorite files and modify the list of favorite files.

The dialog shows a list of files that are currently in the favorite file list.  The following controls are used to manage the list:

Open

The open button opens the selected files from the list and closes the dialog.  Multiple files may be selected from the list and opened at once.  Any changes to the list are saved.  DOUBLE CLICK of any files in the file list will perform the open command.  If one of the selections is a directory, a file open dialog is shown initialized to the specified directory.

Close

The close button closes the dialog.  Any changes to the list are saved.

Add File

The add file button presents a file open dialog allowing the user to browse for a file to add to the list.  If a valid file is selected the file is added to the list.

Add Active File

The add active file button adds the filename of the active file in the editor to the file list.

+All Open Files

The +all open files button adds the filenames of all files in the editor to the file list.

Add Directory

The add directory button allows a user to browse for a directory and add this to the list.  This allows the user to quickly open files from a favorite directory.

Remove File

The remove file button removes any selected files from the file list.


Sum Selected Text/Columns
Sum Columns/Selection (Column Menu)

This command sums the total of all the numbers that appear in the selected area (columns or lines) and presents the total in a dialog box.

As some number formats have a comma, or other character that is part of the number or a separator (i.e. one thousand may be represented as 1,000) this may be configured.  The dialog allows the user to specify any character that should be ignored in a number and by default is initialized to a comma (,).

The SUM button recalculates the total.  It allows the separator to be modified and the total recalculated.

The TOTAL is shown in an editable entry box allowing the total to be formatted and copied to the clipboard and pasted into the document if required.


Scrolling

UltraEdit supports several methods for scrolling.  These are listed below:

Vertical Scrolling

Vertical scrolling is performed with one of the following methods:

Vertical scroll bar

IntelliMouse Support

Ctrl+Up/Down arrows for scrolling up to down by one line

Horizontal Scrolling

Horizontal scroll bar


Project menu commands

The Project menu allows you to manage your projects or workspaces.  This provides an easy way to manage and group associated files.

This functionality combines the grouping of files for quick access via the Files dialog and the saving/restoring of the open files state.

New Project	Create and open a new project file.
Open Project	Open an existing project file.
Close Project	Close a project.
Files	Add, remove or open files within the project.


New Project
New Project (Project menu)

The new project command allows you to create a new project/project file.

A project allows you to manage your projects or workspaces.  This provides an easy way to manage and group associated files.

In many instances a group of files may be related and while editing a particular file there may be reason to edit or view other associated files.  These files can be grouped as a project/workspace.

Grouping these files into a project allows you to easily access and/or open all the associated files when needed without having to search for them.

The project support provides combined project and workspace functionality.  In many cases it may be convenient to use the automatic workspace support as described below:

Workspace

The workspace functionality saves the state of all open files in the project file when the project is closed including window position, cursor position and which files are open.

When a project is opened all the files that were previously opened when the project was closed are opened automatically.  The files do not have to be specifically added to the project via the Files dialog.

Project

The project functionality allows files to be associated together even if they are not currently open in the editor.   Files may be added to the project or removed from the project via the Files dialog.   The files within the project can easily be opened via the Files dialog.


Open Project
Open Project (Project menu)

The open project command allows you to open an existing project that must previously have been created with the New Project command.

When a new project is opened the current project (if opened) will be closed.  The option will be given to close files that are currently open.

When the project is opened, any files that were previously open when the project was last closed will be opened automatically.


Close Project
Close Project (Project menu)

The close project command closes the currently opened project.  The state of all files will be saved in the project file allowing them to be opened automatically when the project is next opened.  The option will be given to close files that are currently open.


Project Files Dialog
Files (Project Menu)

The project files feature allows a user to store the filenames of files associated to the project to allow the user to quickly reference and open in the future.

When the project files menu item is selected, a dialog is displayed that allows the user to open one or more of the files and modify the list of files.

UltraEdit allows a "Project Directory" to be specified and in conjunction with this the option to use "Relative Paths".  If these are set up, UltraEdit will store the filenames relative to the project directory allowing the paths to be maintained (by changing the project directory) if the user moves the project.  The relative paths must be below the project directory.  Additionally, if the "Relative to Project File" setting is checked, the project files will be set as relative files to the directory in which the project file resides.  This allows the project file and its files to be stored in the same directory and when moved together the project directory would not need to be updated.

The dialog shows a list of files that are part of the project.  The following controls are used to manage the list:

Open

The open button opens the selected files from the list and closes the dialog.  Multiple files may be selected from the list and opened at once.  Any changes to the list are saved.  DOUBLE CLICK of any files in the file list will perform the open command.

Close

The close button closes the dialog.  Any changes to the list are saved.

Add File

The add file button presents a file open dialog allowing the user to browse for a file to add to the list.  If a valid file is selected the file is added to the list.

Add Active File

The add active file button adds the filename of the active file in the editor to the file list.

+All Open Files

The +all open files button adds the filenames of all files in the editor to the file list.

Remove File

The remove file button removes any selected files from the file list.

Up to 2000 files may be added to a project.

Optional Wordfile

The Optional Wordfile entry box allows the user to specify a different wordfile to be used for Syntax Highlighting when the project is active.  If the path is fully qualified it will be an absolute path to the wordfile, otherwise the path would be a relative path to the project directory or project file (based on settings above).


Convert Tabs to Spaces
Tabs to Spaces (Format menu)

Use this command to convert all of the TAB characters within a FILE to spaces.  This uses the Tab Settings to determine how the tab character/tab stop is to be interpreted.  The conversion is performed such that the formatting will remain the same.

If a portion of the file is selected/highlighted only the selected portion is converted, otherwise the complete file is converted.

To convert spaces to tabs use the Spaces to Tabs (Leading) or Spaces to Tabs (All) command.


Convert Spaces to Tabs (All)
Spaces to Tabs (All) (Format menu)

Use this command to convert all of the spaces in a file to tabs.  This uses the Tab Settings to determine how the tab character/tab stop is to be interpreted.

The conversion is performed such that the formatting will remain the same.   This will mean that where there are insufficient spaces to replace with a TAB character and retain the same formatting the spaces will be left in place.

If a portion of the file is selected/highlighted only the selected portion is converted, otherwise the complete file is converted.

If you wish to convert only the space at the beginning of a line use the Spaces to Tabs (Leading) command.

To convert tabs to spaces use the Tabs to Spaces command.


Convert Spaces to Tabs (Leading)
Spaces to Tabs (Leading) (Format menu)

Use this command to convert all of the (leading) spaces in a file to tabs.  This uses the Tab Settings to determine how the tab character/tab stop is to be interpreted.

The leading spaces refers to the space at the beginning of a line.  Any spaces after the first non-space character in a line will not be converted.  To convert all spaces in a line use the Spaces to Tabs(All) command.

The conversion is performed such that the formatting will remain the same.   This will mean that where there are insufficient spaces to replace with a TAB character and retain the same formatting the spaces will be left in place.

If a portion of the file is selected/highlighted only the selected portion is converted, otherwise the complete file is converted.

To convert tabs to spaces use the Tabs to Spaces command.


Delete
Delete (Edit menu)

The delete command deletes the selected text or if no text is selected it deletes the character at the cursor.


Delete to Start of Line
Delete to Start of Line (Edit menu)

The delete to start of line command deletes all contents of the current line from the position of the cursor to the beginning of the line containing the cursor.

Shortcut

Keys:	CTRL+F11


Delete to End of Line
Delete to End of Line (Edit menu)

The delete to end of line command deletes all contents of the current line from the position of the cursor to the end of the line containing the cursor.

Shortcut

Keys:	CTRL+F12


Backup/Auto-Save Configuration Items
Backup Configuration Page

The backup configuration page allows the editor backup and auto-save options to be set.  This page provides the following options:

Backup Files on Save

When a file is saved the option to generate a backup file is provided.  Three choices are available:

- No backup file is created - When a file is saved the original file is overwritten and a backup file is not created.

- Replace extension with .BAK - When the file is saved, the original file is copied or renamed to a backup file with the same filename and a ".BAK" extension inplace of the existing extension. The modifications are saved to the original filename/extension.

-Append .BAK to the existing extension - When the file is saved the original file is copied or renamed to a backup file with the same filename and extension and .BAK is added to the filename (filename.ext.BAK).  The modifications are saved to the original filename/extension.

Default Backup Directory

Normally the directory used for the backup file is the same directory as the source file.  This parameter allows all  backup files to be copied to the same backup directory.

If this item is left blank then the directory used will be that of the source file.

Automatic Backup

The option is provided to automatically save all open files at the desired interval.  The interval is configurable in minutes.  If the interval is set to zero (0) no automatic save is performed.

The option is provided for the automatic save to ignore files that do not have a name (i.e. files that were created with the New File command).  This stops the Save As dialog from appearing if an unnamed file exists and has been modified.

If a file is saved due to the automatic backup/save command a .BAK file is only created for the first save of the session.  For subsequent saves with this feature the .BAK file is not created or overwritten.


File Revert Command
Revert to Saved command (File menu)

Use this command to close the active document and reload it losing any changes you have made.  This command is not available if the file is an unnamed file.  A prompt will be displayed confirming the loss of changes.


Open from FTP Command
Open from FTP (File menu/FTP Sub Menu)

Use this command to open a file via FTP.  This command presents a custom dialog that allows selection of the site/account to browse.

A list of configured accounts is shown and any of the accounts may be selected.  If a new account is selected from the list UltraEdit automatically tries to connect to the site and browse it.

A new account must be configured for each site to be connected to as each site may have a different name, password, directory etc.

When the dialog is displayed the browse button will display the list of files for the given site.  Double clicking on any of the directories shown in the list will attempt to change to the specific directory.

The directory list may be filtered to show a sub-set of files by specify a filter in the "Filter" text field.

To open a file, either double click on the file or select it and click on the Open button.  The transfer progress will be shown as the file is transferred.

Additionally the Change Directory button may be used to type in a directory to change to.

While an operation is in progress a warning will be shown if an attempt to start another operation is made, or canceling the dialog is requested.

While files are being transferred, or a site is being connected to the dialog will show the current status.

By default after the file is retrieved and open the dialog will be closed if the option Close Dialog After Open is set.  This option may be cleared to have the dialog remain open.

From this dialog additional FTP functionality is available:

Refresh - 	This refreshes (rereads) the directory information from the host server.

Create Dir - 	This creates a new directory on the host server.  No checking of the name or syntax is performed, any errors are reported back from the host server.

Permissions-	This allows the file permissions to be set on a remote file.  This will only work on servers that recognize the FTP Site command chmod.  Typically this would only be UNIX/Linux servers.

Rename -	This renames a remote file or directory on the host server.

Delete - 	This deletes a remote file or directory on the host server.


Save As to FTP Command
Save As to FTP (File menu/FTP Sub Menu)

Use this command to save an open document/file via FTP.  This command presents a custom dialog that allows selection of the site/account to browse.

A list of configured accounts is shown and any of the accounts may be selected.  If a new account is selected from the list UltraEdit automatically tried to connect to the site and browse it.

A new account must be configured for each site to be connected to as each site may have a different name, password, directory etc.

When the dialog is displayed the browse button will display the list of files for the given site.  Double clicking on any of the directories shown in the list will attempt to change to the specific directory.

The directory list may be filtered to show a sub-set of files by specify a filter in the "Filter" text field.

To save the file, type in the filename or click on an existing filename and click the Save As button.  The transfer progress will be shown as the file is transferred.

While an operation is in progress a warning will be shown if an attempt to start another operation is made, or canceling the dialog is requested.

While files are being transferred, or a site is being connected to the dialog will show the current status.

From this dialog additional FTP functionality is available:

Refresh - 	This refreshes (rereads) the directory information from the host server.

Create Dir - 	This creates a new directory on the host server.  No checking of the name or syntax is performed, any errors are reported back from the host server.

Permissions-	This allows the file permissions to be set on a remote file.  This will only work on servers that recognize the FTP Site command chmod.  Typically this would only be UNIX/Linux servers.

Rename -	This renames a remote file or directory on the host server.

Delete - 	This deletes a remote file or directory on the host server.


FTP Accounts

This dialog allows user FTP accounts to be configured.  The accounts are used for FTP Open and FTP Save As commands.

An account specifies the server to be connected to and the user identification that will be used to connect to the server.

The New Account button allows you to specify a new account name.  The account to modify may be selected from the list of accounts.  If any changes have been made to the account a prompt will be shown asking if the changes should be kept.

The following items may be configured for each account:

Domain or IP Address

This is the ftp site that you wish to connect to such as ftp://ftp.idmcomp.com  This may also be entered as ftp.idmcomp.com.  If preferred the IP Address in the form xxxx.xxxx.xxxx.xxxx may be entered.

Name

This is the username used to log into the server.  The default username is anonymous as this is typically used for anonymous log in to FTP accounts.

Password

This is the password used with the username to log into the server.  The default username is @.  This should be the password for the username as provided by the site administration, or for anonymous log in this is typically the e-mail address of the user.

Save Password

This checkbox determines if UltraEdit will save the password for later reference.  If not the user will be prompted for the password as required.  Note  if the password is saved it is stored on the system.  It is encrypted however the encryption mechanism is unsophisticated and should not be relied upon as a method of security.

User Account

This allows the user to specify an account on the host server when logging.  This is only required with some servers.

Initial Directory

This is the initial directory to connect to on the FTP server.  This is not required.  If this is NOT specified, UltraEdit will remember the last directory for the account each time the user connects to the server.

FTP/Proxy Port

This is the port used by UltraEdit for FTP protocol.  The default is 21.  This may be changed if required.  If using the proxy it is the port used to connect to the proxy for FTP protocol.

Proxy/Firewall Settings

If connecting directly to the Internet the proxy settings should not be enabled.  If connecting via a proxy on a LAN it will be necessary to set up the proxy settings.

Use Proxy

This enables the proxy settings and configures this account to connect through the specified proxy.

Proxy Server

This is the name of the server (or IP address) that is used for the proxy.  If you do not know this name check with your system administrator.

FTP/Proxy Port

This is the port used by UltraEdit for FTP protocol.  The default is 21.  This may be changed if required.  If using the proxy it is the port used to connect to the proxy for FTP protocol.

Advanced

This button provides for additional configuration items for the account.

Use the Delete button to delete an account.


FTP Accounts - Advanced

This dialog allows additional configuration for FTP user accounts.  The accounts are used for FTP Open and FTP Save As commands.

The following items may be configured for each account:

Cache password for session if not saved

If this is checked the password for the account once entered is cached for the period UltraEdit is running and will not need to be reentered.  If the password is entered incorrectly and needs to be changed entering the Accounts dialog and leaving it willclear out the cache.

Domain or IP Address

This allows the transfer type of ASCII or Binary to be set for the account.  Binary transfers the file byte for byte with no modification.  ASCII causes the file to be appropriately converted for line terminations between different systems.

Passive Transfers

Some Firewalls require that the passive mode be used to allow connection.  If you have trouble connecting to an account via a Firewall it may be necessary to enable the Passive Transfer mode.

Server Type

For most FTP servers the default Auto or Unix should work without problem.  However this provides for connection to servers that need special handling.  The list of servers supported is expected to grow.  Currently supported are:

AIX

Auto

File Name Only - this takes the first field returned and displays it as the filename

Stratus VOS - The "Full Path Leading Character" should be set to "%" and the "Path/Node Separator Character" should be set to ">".

UNIX

VAX/VMS

Full Path Leading Character

This allows the user to override the leading character (normally /) for the full path of a file on the server.  If using a server type other than Normal you should not need to change this.

Path/Node Separator Character

This allows the user to override the character (normally /) used between directories/nodes on the server.

If using a server type other than Normal you should not need to change this.


Function List
Function List (Search Menu)

This command shows the list of functions in the active document.  The results are displayed in a dialog in alphabetical order.  By double clicking on one of the result lines UltraEdit will position to that line in the file and the focus will change to the file.  If Enter is pressed while focus is in the Function List UltraEdit will position to that line and focus will remain in the function list.  Ctrl+Enter will also position to the line in the file and the focus will change to the file.

UltraEdit searches for a particular pattern to determine if a line is considered a function.  The pattern that is searched for is a regular expression string that may be modified by the user.

The regular expression string is defined in the wordfile.txt file and each language may have its own definition.

Note - The regular expression string must use UltraEdit style regular expressions.  This ensures that the function list will always work irrespective of the regular expression settings.

See the Syntax Highlighting section for details on changing the string used for recognizing a function.


Tag List
Tag List (View Menu)

This command displays a dialog showing a list of predefined "tags". A tag is simply a short string of characters and the name "tag" is used as this feature is commonly used for "HTML Tags".

The purpose of the tag list is to provide a method to easily insert into a document commonly used tags/strings without having to type them.

The Modify button (right click on tag list for 32-Bit version) allows the list of tags to be modified.  The tags consist of a start and end tag.

To insert a tag, select the tag you wish to insert and double click on the tag or press enter.  When the tag is inserted into the active document, the start tag (if defined) is inserted at the beginning of any text selected and the end tag (if defined) is inserted at the end of the current selection.  If no selection is made the tags are inserted at the cursor location.

By double clicking on one of the tags UltraEdit will insert the tag and the focus will change to the file.  If Enter is pressed while focus is in the Tag List UltraEdit will insert the tag and focus will remain in the Tag List.  Ctrl+Enter will also insert the tag and the focus will change to the file.

Multiple groups of tags may be defined and the group may be selected from the drop-down list.


Tag List Modify

This dialog allows the Tag List to be modified.

A tag is simply a short string of characters and the name "tag" is used as this feature is commonly used for "HTML Tags".

The purpose of the tag list is to provide a method to easily insert into a document commonly used tags/strings without having to type them.

The filename field must be filled in.  This is the file used for storing the tags.  A New File may be created or the Browse button may be used to select an existing tag list file.

The tags may be split into groups for association.  At least one group must exist to add any tags and this may be defined with the New Group button.

Each tag may have a start and end tag.  The tags are entered in the boxes provided and can be inserted to the tag list with the Add Tag button or may be used to Replace the selected tag.

Clicking on an existing tag in the list will fill in the Begin Tag and End Tag boxes for easy modification.

When a new group is added or a different group selected a prompt is issued asking if any changes made should be saved.


Tab Indentation

UltraEdit provides multi-line indentation and out-denting with the tab key.  If multiple lines are selected, the Tab Key will indent these lines with the equivalent of one tab stop.  If the Shift Key is pressed at the same time as the Tab Key the lines will be out-dented by one tab stop.


Project Menu Option
Project Menu on Main Menu (General Configuration Page)

This option configures the editor to include the Project Menu on the Main Menu bar of the editor.  If this option is not checked the Project Menu appears as a sub-menu of the File Menu.

Note - After changing this setting the editor must be restarted for the menus to change.


Recent File List Placement Option
Recent Files List on File Menu (General Configuration Page)

This option configures the recent file list to appear on the File Menu rather than as a sub-menu.  If this option is not checked the recent file list appears as a sub-menu of the File Menu.

Note - After changing this setting the editor must be restarted for the menus to change.


Tree View Control
File Tree View (View Menu)

This menu item enables or disables the File Tree View.

The File Tree View shows a list of files or directories for the selected drive in a tree type format.  The Drive/File List shows the drives available and additionally allows a selection for displaying all the open files or files in the current project.

Double clicking on any of the files in the Tree View will open or activate the file.  Multiple files may be selected and opened at once.  (To select multiple files, use the left mouse button and the shift key to select between two files, or the control key and the left mouse button to select multiple non contiguous files).

Several functions are available by right clicking on the appropriate file.  These are dependant on the list being shown.

Open Files

If the list of files shown are the currently open files the following functions are available when the right click menu is shown:

Close

Save

Print

Tile Horizontal

Tile Vertical

All of the above functions work on ALL the selected files.

Project Files/Drive

If the list of files shown are the currently open files the following functions are available when the right click menu is shown:

Open Selected File 	- This will open the selected file(s) in the editor.

Properties	- This will show the file properties for the FIRST item selected.

Common

At any time right clicking on the Tree View will provide options to hide the view, or to disable the docking.  If it is not docked it will show as a window unattached to other windows.

This feature is supported in the 32-Bit version ONLY.


Print All Files
Print All Files (File Menu)

This command prints all the open documents with the current page setup and printer settings.  To change the settings use the Page Setup or Printer Setup commands from the File Menu.


Output Window
Output Window (View and Window Menus)

This menu item enables or disables the Output Window.  The Output Window is used to capture the output from user tools (see Tools Configuration) or from the Find in Files output.

Double clicking on a line containing the filename and line number will cause UltraEdit to attempt to open the file specified at the line number.  If the filename is fully qualified the filename will be located and the number after this will be used for the line number.  If the filename is not fully qualified UltraEdit will attempt to determine the filename from the first word in the line that contains a period.  UltraEdit will the open the specified file in the directory of the active file.

By double clicking on one of the result lines UltraEdit will position to that line in the file and the focus will change to the file.  If Enter is pressed while focus is in the Output Window UltraEdit will position to that line and focus will remain in the Output Window.  Ctrl+Enter will also position to the line in the file and the focus will change to the file.


File Quick Open command
Quick Open command (File menu)

Use this command to quickly open a file without the delay of showing a file browse dialog.  The directory from which the file is to be opened is show in the dialog.  Relative paths as well as the filename may be entered.

With this command it is also possible to open with wildcards such as "*.txt".

The file selected will be opened or an error displayed.


Silent Installation

Installation of UltraEdit is normally performed by executing the self extracting EXEs (ULTRAEDI.EXE and UEDIT32I.EXE) without any parameters.  This leads the user through the installation allowing the user to select the appropriate location and options.

In some cases it may be desired to perform a silent installation of UltraEdit to allow automated unattended installations.  This is possible with the following settings:

uedit32i /s /m=filename

/s	This indicates a silent install

/m	This indicates the file location (fully qualified path/filename) of the file with the install parameters.

Currently there are two possible install parameters.  If these are not set they will default to the same defaults provided with a normal interactive installation.

MAINDIR=C:\PROGRAM FILES\ULTRAEDT 	- This specifies the installation directory

INSTALL_TYPE=A	- This specifies the install type (The possible options are A=Normal, B=From Network, C=To Network)


Regular Expressions

UltraEdit allows for Regular Expressions in many of its search and replace functions listed under the Search Menu.

Regular expressions allow more complex search and replace functions to be performed in a single operation.

There are twopossible sets of syntax that may be used.  The first table below shows the original UltraEdit syntax used in earlier versions of UltraEdit.  The second table shows the optional "Unix" style regular expressions.  This may be enabled from the ConfigurationSection.

Regular Expressions (UltraEdit Syntax):

Symbol	Function
%	Matches the start of line - Indicates the search string must be at the beginning of a line but does not include any line terminator characters in the resulting string selected.
$	Matches the end of line - Indicates the search string must be at the end of line but does not include any line terminator characters in the resulting string selected.
?	Matches any single character except newline
*	Matches any number of occurrences of any character except newline
+	Matches one or more of the preceding character/expression.  At least one occurrence of the character must be found.
++	Matches the preceding character/expression zero or more times.
^b	Matches a page break
^p	Matches a newline(paragraph)
^t	Matches a tab character
[ ]	Matches any single character, or range in the brackets
^{A^}^{B^}	Matches expression A OR B
^	Overrides the following regular expression character
^(…^)	Brackets or tags an expression to use in the replace command.  A regular expression may have up to 9 tagged expressions, numbered according to their order in the regular expression. The corresponding replacement expression is ^x, for x in the range 1-9.  Example: If ^(h*o^) ^(f*s^) matches "hello folks", ^2 ^1 would replace it with "folks hello".

Note - ^ refers to the character '^' NOT Control Key + value.

Examples:

m?n matches "man", "men", "min" but not "moon".

t*t matches "test", "tonight" and "tea time" (the "tea t" portion) but not "tea

time" (newline between "tea " and "time").

Te+st matches "test", "teest", "teeeest" etc. but does not match "tst".

[aeiou] matches every lowercase vowel

[,.?] matches a literal ",", "." or "?".

[0-9, a-z] matches any digit, or lowercase letter

[~0-9] matches any character except a digit (~ means NOT the following)

You may search for an expression A or B as follows:

"^{John^}^{Tom^}

This will search for an occurrence of John or Tom.  There should be nothing between the two expressions.

You may combine A or B and C or D in the same search as follows:

"^{John^}^{Tom^} ^{Smith^}^{Jones^}"

This will search for John or Tom followed by Smith or Jones.

The table below shows the syntax for the "Unix" style regular expressions.

Regular Expressions (Unix Syntax):

Symbol	Function
\	Marks the next character as a special character. "n" matches the character "n". "\n" matches a linefeed or newline character.
^	Matches/anchors the beginning of line.
$	Matches/anchors the end of line.
*	Matches the preceding character zero or more times.
+	Matches the preceding character one or more times.
.	Matches any single character except a newline character.
(expression)	Brackets or tags an expression to use in the replace command. A regular expression may have up to 9 tagged expressions, numbered according to their order in the regular expression. The corresponding replacement expression is \x, for x in the range 1-9.  Example: If (h.*o) (f.*s) matches "hello folks", \2 \1 would replace it with "folks hello".
[xyz]	A character set. Matches any characters between brackets.
[^xyz]	A negative character set. Matches any characters NOT between brackets.
\d	Matches a digit character. Equivalent to [0-9].
\D	Matches a nondigit character. Equivalent to [^0-9].
\f	Matches a form-feed character.
\n	Matches a linefeed character.
\r	Matches a carriage return character.
\s	Matches any white space including space, tab, form-feed, etc but not newline.
\S	Matches any nonwhite space character but not newline.
\t	Matches a tab character.
\v	Matches a vertical tab character.
\w	Matches any word character including underscore.
\W	Matches any nonword character.

Note - ^ refers to the character '^' NOT Control Key + value.

Examples:

m.n matches "man", "men", "min" but not "moon".

Te+st matches "test", "teest", "teeeest" etc. BUT NOT "tst".

Te*st matches "test", "teest", "teeeest" etc. AND "tst".

[aeiou] matches every lowercase vowel

[,.?] matches a literal ",", "." or "?".

[0-9, a-z] matches any digit, or lowercase letter

[^0-9] matches any character except a digit (^ means NOT the following)

You may search for an expression A or B as follow:

"(John|Tom)"

This will search for an occurrence of John or Tom.  There should be nothing between the two expressions.

You may combine A or B and C or D in the same search as follows:

"(John|Tom)(Smith|Jones)"

This will search for John or Tom followed by Smith or Jones.

Additionally:

\p              Matches CR/LF (same as \r\n) to match a DOS line terminator

If Regular Expression is not selected for the find/replace and in the Replace field the following special characters are also valid:

Symbol	        Function

^^	        Matches a "^" character

^s	        Is substituted with the selected (highlighted) text of the active file window.

^c	        Is substituted with the contents of the clipboard.

^b	        Matches a page break

^p	        Matches a newline(paragraph) (CR/LF).

^t	        Matches a tab character

Note - ^ refers to the character '^' NOT Control Key + value.


Find Configuration Items
Find Configuration Page

The find configuration page allows various find/replace options to be set.  These options are:

Show Slim Find dialog	Show a slim dialog after the initial find command is started with find next/find previous buttons on it.
Continue Search at End of File	When a search reaches the end of file and the string is not found continue the search from the other end of the file.
Unix Style Regular Expressions	Use UNIX style/syntax Regular Expressions.
Find dialog defaults to word under cursor	When set, UltraEdit automatically initializes the find/replace dialogs with the word under the cursor position.  If not set, it uses selected text if present or the last find string.
Find Next/Prev finds selected text	When set, UltraEdit will find the selected text when a FIND NEXT/PREVIOUS command is performed instead of the previous search string UNLESS Regular Expressions is selected.


Font Selection for HEX and Column Mode
Set Hex/Column Mode Font (View menu)

The Set Hex/Column Mode Font menu item presents the Choose Font dialog box that allows selection of different fonts and font sizes.  The selection made will apply when editing in HEX mode or in Column mode.   UltraEdit will automatically switch to this font when HEX or Column modes are selected.

For normal font selection use Set Font from the View Menu.


Line Spacing
Line Spacing (View Menu)

These items provide for Single, 1 ½ and Double spacing.  This allows a document to be viewed and printed with additional spacing between each line of text.

If Single spacing is selected, each line is displayed and printed with the normal character height and line spacing.

If 1 ½ spacing is selected, each line is displayed and printed with the 1 ½ the normal character height for the line.  The actual characters are the normal height but spacing allocated for the line is increased giving additional room for notes to be hand written between lines.

If Double spacing is selected, each line is displayed and printed with the 2 times the normal character height for the line.  The actual characters are the normal height but spacing allocated for the line is increased giving additional room for notes to be hand written between lines.


Directories Configuration Items
Directories Configuration Page

The directories configuration page allows the default directories used by UltraEdit to be configured.  These options are:

Default Save Directory	Set the default directory for saving files with the Save As command
Macro Default Directory	Set the default directory for loading and saving macros.
Template User Directory	Set the directory for the template storage.


File Change Detection
File Change Detection Settings

UltraEdit automatically detects any changes to a file that is loaded within UltraEdit and is changed outside of UltraEdit.

By default, when the changes are detected UltraEdit will prompt the user with the option to reload the file (in which case any unsaved changes to the file in UltraEdit will be lost).  The user may choose to reload the file or ignore the changes.

Optionally, UltraEdit provides the ability to ignore any file changes by setting the "Disable File Change Detection" setting in the General Options configuration page.  In this case UltraEdit will not detect, or prompt for any file changes.

Optionally, UltraEdit provides the ability to automatically update the loaded files with any changes that have been made outside of the editor by setting the "Automatically Update Changed Files" setting in the General Options configuration page.  In this case, the file will be loaded and any unsaved changes made within UltraEdit will be overwritten automatically without prompting.


Save Bookmarks

UltraEdit provides the ability to save the bookmarks for any file that has active bookmarks when a file is closed.  By default the feature is not enabled.  This may be enabled by setting the "Save Bookmarks " setting in the General Options configuration page.

If this option is disabled UltraEdit will delete any saved bookmarks the next time UltraEdit is closed.


ASCII to Unicode
ASCII to Unicode (File Menu)

This function will convert the complete file from ASCII to Unicode (16-Bit wide characters).

The conversion uses the active code page.  For information on code pages see the Windows documentation/help.

The status bar will show a "U-" in front of the file type (DOS/UNIX/MAC) to indicate the file is Unicode.

A file may be converted to ASCII with the Unicode to ASCII command.


Unicode to ASCII
Unicode to ASCII (File Menu)

This function will convert the complete file from Unicode to ASCII.

The conversion uses the active code page.  For information on code pages see the Windows documentation/help.

For Unicode files the status bar will show a "U-" in front of the file type (DOS/UNIX/MAC) to indicate the file is Unicode.  Following the conversion this indicator would not be present.

A file may be converted to Unicode with the ASCII to Unicode command.


Unicode Support

UltraEdit provides support for Unicode (16-Bit wide character) files.

UltraEdit allows direct editing of Unicode files as well as conversion routines for conversion to Unicode with the ASCII to Unicode command and from Unicode with the Unicode to ASCII command.

Unicode file support within UltraEdit is provided on Windows 95, 98 NT and 2000.

As not all operating systems natively support Unicode certain functions convert from Multi-Byte to Unicode or from Unicode to Multi-Byte.  If the active code page (see Windows documentation/help) does not support the characters then the conversion will not convert correctly.

The functions that convert between Multi-Byte and Unicode include Find/Replace and Column Insert.


Auto-Completion

UltraEdit provides the ability to complete words automatically while typing.

There are there three aspects to the Auto-Completion:

- When invoked all the keywords from the Syntax Highlighting will be available in the list (if the file uses Syntax Highlighting).

- In configuration under the EDIT tab a user specified file may be used to provide the strings for Auto-Completion.  In this case a new line is required for each word, or sentence (allowing a complete sentence/paragraph to be specified).

- UltraEdit will search back 50K in the active file from the cursor location for words that match a partially typed word and show these.

By default Auto-Completion is invoked with Ctrl+Space.  When this is invoked a list box is displayed with the possible words/phrases for completion.  If an appropriate word exists it will be highlighted.  Typing additional characters will change the selection as appropriate to a word that matches the partial word typed.

The user may use the cursor keys to change the selected word and at any time use the TAB, SPACE or ENTER to select the word to be used.  Doing so will cause UltraEdit to replace the partially entered word (if present) with the selected word/phrase.

Shortcut

Keys:	CTRL+Space


Select Range
Select Range (Edit Menu)

This presents a dialog allowing the user to specify a range within the file that should be selected/highlighted.

The user is able to specify the line and column for the start and end of the selection.  When the dialog is first displayed the entry fields default to the current selection.

If not in Column Mode, UltraEdit will switch automatically to Column Mode if the start and end columns are specified with different values.


Clipboards
Clipboards (Normal, 1-9) (Edit Menu)

UltraEdit provides up to nine user clipboards for use with the Cut, Copy and Paste commands as well as the standard Windows Clipboard.  The active clipboard may be changed from the Edit Menu, or the Right Click context menu.

When changing the active clipboard the contents of the clipboards are not modified.  With the exception of the standard Windows Clipboard the contents of the clipboards are destroyed when UltraEdit is closed.

The active clipboard is shown in the Status Bar following the Line and Column indicator separated with a comma.


Auto-Correct
Auto-Correct (Syntax Highlighting)

If Syntax Highlighting is enabled UltraEdit will automatically (optionally) check each word against the keywords in the wordfile and if the word matches except for the case of the word UltraEdit will correct the word to match the case in the wordfile.

For this to work, the current file must be highlighted with Syntax Highlighting and the language as specified in the wordfile must NOT have the "Nocase" command word specified.

Auto-Correct


Synchronized Scrolling
Synchronized Scrolling (Window Menu)

If this feature is enabled UltraEdit will scroll all windows that are not minimized when any of the windows are scrolled vertically.  This allows viewing two (or more) files together without the need to scroll each one individually.

When the user clicks on the vertical scroll bar to provide scrolling, or on the up/down arrows on the vertical scroll bar the windows will be scrolled together.

Additionally if the user uses the Ctrl+Up/Down for scrolling the windows will be scrolled together.

If the user uses the cursor keys to reposition the file the windows will not be scrolled together allowing the user to change position in one file without affecting another file.

Scrolling by dragging the Thumb on the vertical scroll bar will attempt to scroll the windows together, however this method on large files may not keep the files synchronized.


View File as Specific Language Type
View as (Highlighting File Type) (View Menu)

This allows the user to override the Syntax Highlighting selection made by UltraEdit based on the file extension and view any file as one of the available languages.

The menu selection allows selection for any of the languages available within Syntax Highlighting and a selection of no highlighting.

If the user uses this feature to override the syntax highlighting the override will stay in effect until the file is closed, or saved under a new name.


Make Copy/Backup
Make Copy/Backup (File Menu)

This allows the user to make a backup copy of the active file (with any current changes) without affecting the active file.

The active file maintains the current file name and does not change name unlike the Save As command.


OEM Character Set
OEM Character Set (View menu)

This setting forces all fonts to show upper ASCII characters with the OEM Character Set (assuming the font supports it).  This allows DOS files with upper ASCII characters to be shown correctly with the ASCII character set instead of with the ANSI (Windows) character set.


Comment Add/Remove
Comment Add/Remove (Edit menu)

These commands allow line comments (as defined in Syntax Highlighting) to be added to or removed from the selected lines.  The file being edited must be enabled with Syntax Highlighting and line comments must be defined for the particular language.

If the line comments are appropriately defined, these functions will add the line comment characters to the beginning of each line or remove the line comment characters from the beginning of each line.  When removing comment characters, the characters will only be removed if they are the first characters in the line.


Selecting Text

UltraEdit provides several methods for selecting (highlighting) text.  In general, using the Shift Key and cursor keys will select text as will using the Shift Key and mouse positioning.

Additionally, there are several other methods that make it easier to select a range of text.

When the Shift Key is pressing at the same time as performing the following functions the current selection (if present), or a new selection will be extended to select text up to the cursor position following the command:

Find Next/Previous

Goto

Goto Bookmark

The Shift Key should be pressed at the time the action for command takes place, not on the command that shows the dialog.  For example, if Ctrl+G displays the Goto Dialog and OK is clicked to perform the Goto, the Shift Key is pressed when the OK is clicked, NOT when the Ctrl+G is pressed to display the dialog.


Spelling Checker

You can get help on the following topics:

Check-Spelling Dialog

Options Dialog

Dictionaries Dialog

New-Dictionary Dialog

Sentry Spelling-Checker Engine, Copyright 1996 by Wintertree Software Inc.


Check-Spelling Dialog

The Check-Spelling Dialog appears if a word requiring your attention is detected. You can use the dialog to specify whether the word should be ignored or replaced.

Add button: Causes the reported word to be added to the dictionary selected in the Add Words To list. Use the add button if a correctly spelled word you use often is reported as a misspelling (e.g., your family name). If the word is not used frequently, you may want to select the Ignore or Ignore All buttons instead.

Add Words To list: Indicates which user dictionary words will be added to when you select the Add button. The Add Words To list shows all ignore-type user dictionaries currently open. You can open or close other dictionaries via the Dictionaries dialog, which is accessible by selecting the Dictionaries button.

Cancel button: Stops the current spell-checking operation.

Change button: Causes the reported word to be replaced with the word in the Change To box. Only this occurrence of the reported word is replaced. If you want this and all following occurrences of the word replaced, select the Change All button.

Change All button: Causes this and all following occurrences of the reported word to be replaced with the word in the Change To box. If you want only this occurrence of the word to be replaced, use the Change button. If the reported word is one you frequently misspell, you might consider adding it to a change-type or suggest-type dictionary via the Dictionaries dialog. You can display the Dictionaries dialog by selecting the Dictionaries button.

Change To box: Contains a word which will replace a misspelled word when you select the Change or Change All buttons. You can enter a word in the Change To box by typing, or you can select one of the suggested replacements from the Suggestions list.

Consider Changing box: Contains a word which may be misspelled or otherwise incorrect, and is presented with a candidate replacement word. You can change the word by selecting the Change button, or skip it by selecting the Ignore button. Note that the label of this box changes to Not in dictionary when a misspelled word is detected.

Dictionaries button: Causes the Dictionaries dialog to be displayed. You can use the Dictionaries dialog to open or close user dictionaries, and to edit the contents of user dictionaries.

Ignore button: Causes this occurrence of a misspelled word to be skipped. If the same misspelled word appears later, it will be reported.

Ignore All button: Causes this and all further occurrences of a misspelled word to be skipped. You might use this button if the word reported as a misspelling is actually spelled correctly. If the word is one you use frequently, you may wish to ignore it permanently by selecting the Add button.

Lock Pos. check-box: Locks the position of the Check-Spelling dialog in place. Normally the Check-Spelling dialog attempts to position itself to avoid the window containing the text being checked. When the Lock check-box is checked, the Check-Spelling dialog will always appear at the last place you positioned it.

Not in dictionary box: Indicates that a misspelled word was detected. The word is considered misspelled because it could not be located in any open dictionaries, or was located in an exclude-type dictionary. Note that the label of this box changes to Consider changing when a word and a suggested replacement are displayed.

Options button: Causes the Options dialog to be displayed. You can use the Options dialog to set spelling-checker options.

Suggest button: Search more thoroughly for suggested replacements for the current misspelled word. Each time you press the Suggest button, a "deeper" search is made. The Suggest button is disabled once all possible suggestions have been located.

Suggestions list: Contains a list of suggested replacements for the word reported as misspelled. This list is filled in automatically when a misspelled word is detected. Subsequent presses of the Suggest button may yield more suggestions. A word selected in this list will be automatically copied to the Change To box, where it can be substituted for the misspelled word by pressing the Change button.


Dictionaries Dialog

The Dictionaries Dialog allows you to open and close user dictionaries, and to edit the contents of an open user dictionary. The contents of dictionaries are saved in disk files. You can open some or all of your user dictionary files at any time. Only open dictionaries are checked during a spell-checking operation.

Add File button: Opens a user dictionary file. When you select the Add File button, a dialog appears which you can use to select the dictionary file to open. The set of open dictionary files is remembered, so once you add a dictionary file you don't need to add it again. If you need to create a new user dictionary, use the New button. You can open other applications user dictionary files.

Add Word button: Causes the word entered in the edit area of the Words list to be added to the currently selected dictionary. Note that if the dictionary type is "auto change" or "conditionally change," you must enter a word and a replacement, separated by a colon (e.g., "teh:the"). Note that the Add Word button is enabled only when a new word is typed in the edit area of the Words list. The words you add may contain virtually any character, but only words which contain embedded periods should have trailing periods (e.g., U.S.A. is OK, but USA. is not).

Close button: Closes the Dictionaries dialog.

Delete Word button: Causes the word appearing in the edit area of the Words list to be removed from the currently selected dictionary. If the dictionary type is "auto change" or "conditionally change," enter just the word without the colon or replacement word.

Export button: Saves the contents of the currently selected dictionary to a text file. When you select the Export button, a dialog appears which you can use to select the name of the text file to which words in the dictionary will be exported. The words are written to the file one per line. If the dictionary type is "auto change" or "conditionally change," words and their replacements are written, separated by a colon.

Files list: Contains the list of open dictionary files. When you select a file from the list, its contents are displayed in the Words list.

Import button: Adds the words contained within a text file to the currently selected dictionary. When you select the Import button, a dialog appears which you can use to select the text file to be imported. Each word in the selected file is loaded into the dictionary. If the dictionary type is "auto change" or "conditionally change," words in the file must be in word:replacement form (e.g., "teh:the").

Language: Displays the language (e.g., English or French) of the words in the currently selected dictionary.

New button: Creates a new user dictionary file. When you select the New button, a dialog appears which you can use to specify attributes of the new dictionary. See the New Dictionary dialog for details.

Remove File button: Closes the currently selected dictionary file. Closed dictionaries are not checked during a spelling check. Although the file is closed, it is not deleted. Closed dictionary files can be later reopened using the Add File button.

Type: Displays the type or purpose of the currently selected user dictionary. The dictionary type indicates what will happen if a word is located in the dictionary during a spelling check.

Words list: Contains the list of words in the currently selected user dictionary. If the dictionary type is "auto change" or "conditionally change," then the list contains words and their replacements, separated by colons.


Options Dialog

You can use the Options Dialog to specify various spelling-checker options. These options affect the way the spelling checker operates.

Ignore Capitalized Words: When enabled, any words beginning with a capital letter are ignored (i.e., are skipped over without being checked). You might enable this option if the text being checked contains many proper names.

Ignore All-Caps Words: When enabled, any words containing all capital letters are ignored (i.e., are skipped without being checked). You might enable this option if the text being checked contains many acronyms.

Ignore Words with Numbers: When enabled, any words containing embedded digits are ignored (i.e., are skipped without being checked). Examples of such words include "Win95" and "Q4." You might enable this option if the text being checked contains many code-words or other symbols containing digits.

Ignore Words with Mixed Case: When enabled, any words containing an unusual mixture of upper- and lower-case letters are ignored (i.e., are skipped without being checked). Examples of such words include "MicroHouse" and "CapsLock." You might enable this option if the text being checked contains many variable names or other symbols which use case changes to distinguish words.

Report Doubled Words: When enabled, any word appearing twice in a row is reported via the Check-Spelling Dialog.

Case Sensitive: When enabled, a distinction is made between capitalized and non-capitalized words. For example, canada is considered different from Canada, so canada would be reported as a misspelling. When the option is disabled, canada and Canada are considered identical.

Phonetic Suggestions: When enabled, suggestions are made on the basis of phonetic (sounds-like) similarity to the misspelled word. This option tends to improve suggestions for badly misspelled words. Enabling this option will increase the time required to locate suggestions. Note that either this option or the Typographical Suggestions option must be enabled or no suggestions will be offered.

Typographical Suggestions: When enabled, suggestions are made on the basis of typographical (looks-like) similarity to the misspelled word. This option is appropriate for people who are generally good spellers. Note that either this option or the Phonetic Suggestions option must be enabled or no suggestions will be offered.

Suggest Split Words: When enabled, two separate words will be suggested as a replacement for a misspelling containing two joined words. For example, is the would be suggested as a replacement for isthe.

Match Case in Replacements: When enabled, suggested replacements for misspelled words will use the same letter-case pattern as the misspelled word. When disabled, the replacements will use the case pattern of the word as it exists in the dictionary. This option also applies to words defined in auto-change and conditional-change dictionaries.

Auto Correct: When enabled, words defined in auto-change dictionaries will automatically be changed to their specified replacements. When disabled, you will be prompted before the words are changed.

Suggestions: Determines the speed and accuracy of the initial search for suggested replacements for misspelled words. When a misspelled word is detected, a search is automatically made for suggestions. This option controls the speed and accuracy of this automatic search. Pressing the Suggest button in the Check-Spelling dialog causes an increasingly more accurate (but slower) search for suggestions.

OK button: Closes the Options Dialog, and saves any changes made to the option settings.

Cancel button: Closes the Options Dialog, and discards any changes made to the option settings.


New Dictionary Dialog

You can use the New Dictionary Dialog to specify the attributes of a new user dictionary.

Browse button: Displays a dialog which shows the names of other user dictionary files. You can use the dialog to view the names of existing dictionary files, and to enter the name of the new dictionary file.

Cancel button: Closes the New Dictionary Dialog without creating a new dictionary.

File Name box: Contains the name of the disk file used to hold the new dictionary's contents. You can enter a name here or use the Browse button to display a dialog showing the names of other dictionary files.

Language list: Specifies the language (e.g., French, English) of the words the new user dictionary will contain. If the language you want to use is not listed, select "Other."

OK button: Closes the New Dictionary Dialog and creates the new dictionary.

Type list: Specifies the type or purpose of the new user dictionary. The type defines what happens when a word is located in the dictionary during a spelling check.


Dictionary Types

User dictionaries can be in several different types. The type indicates what happens when a word is found in the dictionary during a spelling check.

Auto Change: Words found in an Auto Change dictionary are automatically replaced with other words. Typically, Auto Change dictionaries hold frequently misspelled words and their correct replacements. For example, an Auto Change dictionary might contain the misspelled word "recieve" and its replacement "receive." Each entry in an Auto Change dictionary contains a word and the replacement, separated by a colon (e.g., "recieve:receive"). Note that Auto Change dictionaries behave in the same manner as Conditional Change dictionaries if the Auto Correct option is disabled.

Conditional Change: Words found in a Conditional Change dictionary are presented to you as candidates for replacement, and are replaced with other words if you request. Typically, Conditional Change dictionaries hold potentially misspelled words and their usual replacements. Each entry in a Conditional Change dictionary contains a word and the replacement, separated by a colon (e.g., "recieve:receive").

Exclude: Words found in an Exclude dictionary are always considered misspelled, even if they are defined in other dictionaries. Typically, Exclude dictionaries hold words you may use but don't want to appear in your writing. You might also use an Exclude dictionary to hold words you type by accident -- for example, you might enter "newt" in an Exclude dictionary if you occasionally type "newt" when you mean to type "neat."

Ignore: Words found in an Ignore dictionary are considered correctly spelled. Typically, Ignore dictionaries hold words you use but which don't appear in the other dictionaries. For example, you may add your family name or street name to an Ignore dictionary.